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PREFACE 



This manual contains descriptions of and procedures for using all 
Perkin-Elmer disk utilities and is intended for system operators, 
software maintenance personnel and users of stand-alone systems. 

Chapter 1 contains a general description of the utilities. 
Chapter 2 describes the OS/32 Spooler, and Chapter 3 describes 
the Disk Backup Utility. The OS/32 Accounting Reporting Utility 
and the Error Reporting Utility are covered in Chapters 4 and 5, 
respectively. The Disk Dump Utility is covered in Chapter 6. 
The Dump Print Utility is presented in Chapter 7. The Mirror 
Disk Synchronization Utility is described in Chapter 8. Appendix 
A contains the contents of a magnetic tape produced by a 
stand-alone dump from a uniprocessor. Appendix B contains the 
display of the Dump Print Utility output from a Model 3200MPS 
System. 

This manual is intended for use with the OS/32 R07.2 software 
release or higher. 

Revision 02 of this manual expands the Accounting Reporting 
Utility to include auxiliary processing unit (APU) user data as 
well as central processing unit (CPU) user data for the Model 
3200MPS System. The Report Account formats have been realigned 
to make the accounting data more discernable. There are 
modifications to the OS/32 Spooler with the addition of four new 
START command options, five new run-time commands and two 
enhanced run-time commands. OS/32 Backup is also improved with 
the addition of eight new START command parameters. The Error 
Reporting Utility includes a new format for the output of memory 
error reports from the Model 3205 System. In addition, new 
system-detected error report types have been added that are 
applicable to the Model 3200MPS System. Information about the 
Synchronization Utility, a component of the Mirror Disk Facility, 
is provided in Chapter 8. Additionally, a more current saimple 
display of the Dump Print Utility from a Model 3200MPS System has 
been included in Appendix B. 

Discussions of the Disk Initializer Utility and the Disk 
Integrity Check Utility have been removed since these utilities 
are no longer supported for the OS/32 R07.1 release and higher. 
They have been replaced by the Fastchek Utility, which 
incorporates the capabilities of both. See the OS/32 Fastchek 
Reference Manual for a complete discussion of the Fastchek 
Utility. 

For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
SYSTEM SUPPORT UTILITIES 



1.1 INTRODUCTION 

System support utilities include the fo Howling: 

• OS/32 Spooler 

• Disk Backup 

• Accounting Reporting 

• Error Reporting 

• Disk Dump 

• Dump Pr int 

• Mirror Disk Synchronization 

A brief overview of the capabilities of the system support 
utilities is represented below. 

• The OS/32 Spooler allows input/output (I/O) to a slow device, 
such as a printer, to be placed on mass storage devices to 
await transmission. 

• The Disk Backup Utility provides a fast way to save files to 
magnetic tape or disk and restore files to disk. 

• The Accounting Reporting Utility generates reports or archival 
files from the accounting information recorded by the 
Accounting Data Collection Facility. These reports and files 
are generated through operator commands. 

• The Error Reporting Utility produces reports from the error 
log information recorded by the hardware error logger and 
stored on the error log file by the operating system. 

• The Disk Dump Utility dumps information from a disk to 
magnetic tape, restores a previously dumped disk volume from 
magnetic tape, verifies that the data is correctly restored, 
and displays information contained on a disk volume in a 
format useful for debugging system routines that manage direct 
access volumes. 
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The Dump Print Utility interprets and prints to a list device 
the contents of the memory dump previously copied from memory 
to magnetic tape by the panic dump program. 

The Mirror Disk Synchronization Utility provides initial 
synchronization and restoration of a synchronous state after 
a disk failure, while still providing full availability of 
data. It is a support component of the Mirror Disk Facility. 
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CHAPTER 2 
OS/32 SPOOLER 



2.1 INTRODUCTION 

The OS/32 package (R06.2 or higher), comes with two spooler 
tasks : 



• OS/32 Spooler 

• SPL/32 Spooler 

OS/32 Spooler is Perkin-Elmer ' s first generation spooler and, 
prior to the 6.2 release, was the only spooler available with 
OS/32. As such, the OS/32 Spooler provides the basic 
input/output (I/O) spooling services discussed in the remainder 
of this chapter. 

The SPL/32 Spooler offers a more extensive range of features and 
capabilities than the OS/32 Spooler. The SPL/32 Spooler is the 
latest spooling product offered with the OS/32 operating system. 
For a detailed discussion of the capabilities of SPL/32, see the 
SPL/32 Spooler Administration Reference Manual. 

The system administrator determines which spooler will be used on 
a system by selecting the appropriate system generation (sysgen) 
statement. Only one spooler can be active on the system at any 
given time. The System Generation/32 (Sysgen/32) Reference 
Manual presents detailed information regarding the appropriate 
procedures for sysgening either spooler. 



NOTE 

The manner in which pseudo devices are 
specified and used in the spooling 
environment is different for the two 
spoolers. Pseudo devices created for the 
OS/32 Spooler are incompatible with 
pseudo devices created for the SPL/32 
Spooler. Do not attempt to mix the 
Vcirious pseudo device types. 
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2.2 INPUT SPOOLING 

The input spooling feature provides facilities for copying a 
batch strecun of cards such as source programs, operator commands, 
command substitution system (CSS) files or other user data to 
disk files for subsequent processing. Each card deck can be 
spooled to a unique user-specified file for convenient access. 
One or more card readers can be designated as spool devices in 
the START command to a spooler task. All readers so defined are 
exclusively assigned to the spooler. 

The spooler periodically monitors the status of the card readers 
by issuing supervisor call 1 (SVCl) reads to them. If status 
X'AO' is returned (device unavailable), the spooler goes into a 
time wait state. The length of this time wait can be specified 
as an option in the START command. The default is 30 seconds. 
Another read is issued at the conclusion of the interval. 

A reader control statement specifies the disk file to which the 
input is being spooled. Data cards to be copied must be preceded 
by a control card. 

Format : 

/@ INPUT fdCo] 
/§SUBMIT fdQo] 

Parameters: 



fd is the file descriptor of the disk file in the 

form vo In: filename. ext/actno. An index file 
is allocated with name fd. If volume name is 
omitted, the file is allocated on the default 
spool volume. 

D specifies that if a file with the same naime 

already exists, the file is deleted and 
reallocated . 



The /gSUBMIT control statement is used only in a multi-terminal 
monitor (MTM) environment. If the file already exists and D is 
not specified, or if the control card is syntactically wrong, the 
spooler logs a message to the console. Cards are read until 
another /@ INPUT or /©SUBMIT statement is found. In this way, 
stacked input is processed even if an intervening deck contains 
an error. The ending control statement that halts input spooling 
is defined as follows: 



/§ (columns 1 and 2) 
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Data is copied from the cards to the disk file until a /@, 
/§ INPUT or /©SUBMIT statement is read. In the last two cases, 
another copy operation is performed and a warning message is 
logged. If the card reader returns a status X'AO' before an 
ending control card is read, the spooler assumes an incomplete 
input and retries the read until encountering more data. Other 
spooler functions, such as printing and punching to or reading 
from other spool devices, continue. Input spooling continues 
until the last control card is read and the next I/O returns 
device unavailable. The time wait is then reissued. The 
resulting disk files can now be explicitly assigned and read by 
the user in order to access the spooled information. 

2.3 OUTPUT SPOOLING 

Output spooling provides facilities for more than one task to be 
simultaneously assigned to one or more output devices. The 
output spooling feature supports print and card punch devices. 
Data to be punched or printed is written to disk files from which 
it is copied by the spooler to the available output devices. The 
user interface for card punches is compatible with the interface 
for output spooling to the line printer. Spool files are 
uniquely identified within the operating system by a commercial 
at symbol (§) as the first character of the filename. 

To spool output, the user assigns a logical unit (lu) to a pseudo 
device, defined at sysgen time. There is no limit to the number 
of tasks or logical units that can be assigned to a pseudo 
device. The operating system automatically intercepts all 
assignments to* a pseudo device and allocates a file on the spool 
volume. Subsequent SVCl write calls cause data to be written to 
this file and not to the pseudo device. The spooler supports 
both image and formatted output . 

Form feeds can be issued after a banner page or at the end of 
each printed file. 

NOTE 

If the logical record length of a 
physical output device is less than 110 
characters wide, spooler will output the 
banner page in a narrow format of only 55 
characters. However, the narrow format 
will contain all the information that 
would be contained in the full-width 
format. 
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When the user closes the lu assigned to a spool file, the 
filename, task naune, task priority and number of records in the 
file are placed on the spool queue. The spool queue is a file on 
the spool volume maintained by the spooler. If the PURGE option 
was entered when the spooler was started, the f ilenaimes of files 
that do not exist on the spool volume are deleted from the spool 
queue. The operator commands .SPL PRINT and .SPL PUNCH can be 
used to invoke the spooler to output a user file. It is up to 
the user to ensure that sufficient disk space is available to 
accommodate output spooling. The user task (u-task) generating 
the spooled output is responsible for handling, within its own 
standard I/O recovery routines, an end of medium (EOM) status 
occurring while writing to spool files. 

If the user desires multiple copies of a file, data can be 
written to any user-defined disk file. Subsequently, a .SPL 
PRINT or .SPL PUNCH command can be issued to print multiple 
copies of the file (see Section 2.4.2). Unless OPTION NOHEADER 
has been invoked, a header page with the following information 
precedes the printing of each spool file: 

• Task id or filename 

• User account number 

• Time of day 

• Date 



The account number is for all tasks executing in the foreground 
and background environments- See the OS/32 Multi-Terminal 
Monitor (MTM) Reference Manual for information on account 
numbers. Output to card punch devices is preceded by a header 
card that helps to identify the file. The information is the 
Scune as that given on the header page for print devices. All 
fields not used in the display of filenaime, account number, etc., 
contain asterisks (*). To facilitate separating any files that 
have been punched on cards, a trailing card is output. This card 
contains punches in every row from columns 1 to 66. 

2.4 OPERATING INSTRUCTIONS 

The spooler is provided in object format with the OS/32 package. 
The spooler must be built as a nonpr ivileged u-task and must be 
loaded with the task identifier (taskid) .SPL. See the OS/32 
Utilities Packaging Document. 

Example: 

LOAD .SPL, SPOOLER. TSK 
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2.4.1 Starting the Spooler 

The STT^T command specifies to the spooler task which devices are 
to be assigned exclusively for the spooling operation. 

The format for the START command is as follows: 



Format : 



SIART 



,pseudo dev=' 



[^CQMMAiro=fd] 



fd 



,(fdi ,fd2 ..... ffdn), 



fd 



rCARD^ 



^(fdi ,fd2, . . . ,fdn) 



|7t=sss] C,M=nIl 



, OPTION 



(fdi ,fd2 



fd \ r^NQHE7UDER| 

l2,...,fdn)) l\ W^^mL 



( £R0TECT I 

_(hqerotectL 



jNOflFFn rpQIFPV 
( MIIOCONTINUE ] 



[7QyQL=voln:] 

[7Ma.SDEVS=nnnn] 

|7MXESJEUD0=mmmm^ 

(fLlEQ ) 

,qq:bder-)lieq ( 

)ERlQaiZE( 

[7purgeI1 
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Farsuneters: 



pseudo dev= 



specifies the device naime to which files will 
be output for spooling. The name of the 
physical device on which these files will 
actually be printed or punched is f d . A 
physical device can be assigned to more than 
one pseudo device. When multiple physical 
devices are associated with a single pseudo 
device, the device attributes for the first 
physical device specified apply to all of the 
remaining devices. It is advisable to 
associate only devices with like device 
attributes with a common pseudo device. 



COMMAND" 



fd specifies the input device or file from 

which additional paraimeters are to be taken. 

By using this parameter, a user 

more pareimeters than can fit 

command line. This parsuneter 

anywhere in the parsimeter 

parameters in the list are processed before 

any paraimeters are taken from the specified 

fd. 



may specify 
on a single 
may appear 
list. All 



Any parameters contained in the command file 
must be in the same format as if they were 
issued from the START command line. The 
paraimeters within the specified fd are 
processed until end of file (EOF) is 
encountered . 



CARD= 



fd is a required keyword for input spooling 
and specifies input devices to be used for 
spooling. 



T= 



3sa specifies the number of seconds between 
retries on input spooling. The default is 30 
seconds . 



M= 



n specifies the number of message buffers 
be used by the spooler. The default is 10, 



to 



OPTION 



specifies the options in effect for the device 
specified by fd. When a series of devices 
(fd) are specified, the OPTION subparaimeters 
apply to all devices, as in Example 3 below. 
In addition, different OPTION subparameters 
may also be specified for each real or pseudo 
device. 
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Whenever two or more OPTION subparameters are 
used, they must be enclosed within 
parentheses, as indicated in Exeimples 2 and 3 
below. If one OPTION subparameter is used, as 
shown in Exsimple 1 below, no parentheses are 
required. 



NOHEADER 



HEADER 



specifies that no banner page is to precede 
spooled output to the specified fd. If this 
parciroeter is omitted, HEADER is the default. 

specifies that a banner page is to precede 
spooled output to the specified fd. This 
parameter is the default. 



PROTECT 



specifies that only those files that are 
either assigned to that device or specified in 
the DEVICES=fd statement in the PRINT or PUNCH 
parameter of the .SPL command are output to 
the specified device. Files are not spooled 
to a device simply because it is available. 



NOPROTECT 



makes the specified device available 
print/punch requests. 



for all 



NOBFF 



specifies that no form feed will be sent at 
the end of a banner page. Text will begin 
immediately after the date line of the banner. 



BFF 



specifies that a form feed will be sent to the 
printer at the end of the banner page. This 
parameter is the default. 



NOTFF 



specifies that no form feed will 
the end of a printed file. 



be sent at 



TFF 



specifies that a form feed will be sent to the 
printer at the end of a printed file. This 
parameter is the default. 



AUTOCONTINUE 



causes OS/32 Spooler to periodically poll a 
device in the 'not ready' state to see if it 
is ready to continue. When the device is 
ready, the spooler will automatically continue 
output to that device. 



NOAUTOCONTINUE causes OS/32 Spooler to cease output to a 

device in the 'not ready' state until the user 
enters a CONTINUE command for that device. 
This parameter is the default. 



48-031 FOO R02 



2-7 



QVOL= 



voln: allows a user to specify the volume on 
which the spool queue is to reside. If this 
parcimeter is omitted, OS/32 Spooler will 
establish the spool queue on the current spool 
volume. This parameter must be followed by a 
colon. 



MAXDEVS= 



nnnn specifies the maximum number of physical 
devices allowed. If this parameter is not 
specified, the default maximum number of real 
devices is as follows: 



2 



MXPSEUDO= 



where n is the number of logical 
specified when the task is built. 



units 



mmmm specifies the maximum number of pseudo 
devices allowed. If this parsimeter is 
omitted, the maximum number of pseudo devices 
is the same as the number of real devices. 



QORDER- 



defines the order in which entries are placed 
and maintained on the SPOOL queue file. This 
parameter will also determine how the entries 
are selected for output. The default is 
PRIORITY. 



FIFO 
LIFO 
PRIOSIZE 



PRIORITY 



PURGE 



specifies f irst-in/f irst-out queue order. 

specifies last-in/first-out queue order. 

specifies that the queue is to be maintained 
in ascending order of task priority; entries 
of equal priority will be maintained in 
ascending order according to file size. 

specifies that the queue is to be maintained 
in ascending order of task priority regardless 
of file size- 
causes filenames of files that cannot be found 
on the spool volume by OS/32 Spooler to be 
purged from the spool queue. These filenaimes 
are purged when they reach the top of the 
spool queue. 
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Example 1: 

START, PR=PR1: ,PR2=(TTY1: ,TTY2: ,TTY3 : ) , CARD=CR: 
,T=60,M=2,OPTION TTY1:,N0H 

In this case, PRl: , TTYl: , TTY2 : , TTY3 : and CR: are actual 
device naumes as specified at sysgen time. PR and PR2 are pseudo 
devices defined at sysgen to be used for output spooling. If a 
user program assigns an lu to PR, output is spooled, eventually 
to be output on device PRl:. If a user program assigns an lu to 
PR2, output is spooled, eventually to be printed on either TTYl:, 
TTY2: or TTY3 : . Header output on device TTYl: is disabled 
since option NOH has been used. This option applies to the 
physical device TTYl:. If a user program assigns an lu to PRl: 
directly (assuming it is available; i.e., not assigned by the 
spooler), output is not spooled and is sent directly to device 
PRl:. Device CR: is used for input spooling. 

Example 2 : 

START , PR- ( PRl : , PR2 : ) , OPT PR2 : , (NOH , TFF ) , PURGE , QOR-F I FO 

In this case, PRl: and PR2 : are actual device names specified 
at sysgen time. PR is a pseudo device defined at sysgen to be 
used for output spooling. If a user program assigns an lu to PR, 
output is spooled to be generated either on PRl: or PR2 : . Files 
spooled to PR2: are printed without a banner page. A form feed 
will be sent to the printer at the end of the printed file. The 
PURGE parameter tells OS/32 Spooler to delete any filenames for 
files not on the spool volume from the spool queue when they 
reach the top of the queue. Entries on the spool queue file are 
placed and maintained in FIFO order. Since both time and message 
buffer options are omitted, the following defaults are taken and 
no input spooling is requested: 

• T = 30 seconds 

• M = 10 messcige buffers 
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Example 3 : 

START, SPR1=PR1: ,SPR2=PR2 : ,SPR3= (PRl: , PR3 : ) , CARD=CR: 

,PNCH=CRDP: , OPT I ON (PRl: , PR2 : ,PR3: ) , (NOB, NOT, AUTO) 
,QOR=PRIOS 

In this case, the pseudo devices are SPRl, SPR2, SPR3 , CARD and 
PNCH. The associated device names are PRl:, PR2:, PR3 : , CR: and 
CRDP:. SPRl causes output to be spooled and output on PRl:. 
SPR2 causes output to be spooled and output on PR2:. SPR3 causes 
output to be spooled and output on either PRl: or PR3 : . CARD 
causes input to be spooled from device CR: . PNCH causes output 
to be spooled and output on CRDP:. The OPTION subparameters in 
effect for physical devices PRl:, PR2: and PR3 : are NOB, NOT 
and AUTO. Therefore, text will be printed immediately after the 
banner page, no form feed will occur at the end of the printed 
file and, when a device is in a not ready state, the spooling 
operation pauses and then automatically continues when that 
device is ready. The queue is to be maintained in ascending 
order of task priority. Tasks of equal priority will be 
maintained in ascending order of size. 

Example 4: 

ST,COMM=SPL.CMD 

The above exeimple indicates the use of a user-specified command 
file (SPL.CMD) within the START command. This file may contain 
any of the spooler START command parameters. For convenience, 
separate command files can be established for individual spooler 
operations . 

Exeunple 5: 

Use of multiple pseudo device names enables the user to direct 

output to a separate device or a group of devices. In the 

following exsunple, output is being directed from multiple pseudo 
devices to one physical device. 

ST , PR=PRT : , PR1=PRT : , . . . 



2-10 48-031 FOO R02 



SPL 



2.4.2 .SPL Co][Tuneutd 

The .SPL command controls spooling operations. Input and output 
spooling is supported by the card reader, card punch and printer. 
The spool volume specified at sysgen can be changed by the VOLUME 
operator command. See the OS/32 Operator Reference Manual. 

The spooler operations available for use with the .SPL command 
follow. 



48-031 FOO R02 2-11 



Format: 



r 



.SPL c^ 



ADD 



2E£,ETE 



dev: 1 

pseudo-dev: ) 
( dev: I 

pseudo-dev: ) 
MTACH pseudo-dev: , dev: 
DETACH pseudo-dev: , dev: 
HOLD fd 
EELEASE fd 

{dev: y 

> 
pseudo-dev: )_ 

BACKWARD fd,n 

£ORWARD fd,n 

CANCEL fd 

CONTINUE fd 

REWIND fd 

aUSPEND fd 

INQUIRE [lASK=tttttttt] C,13EV=pdv] CaCCOUNT-aaaaa] C,LIST=f dj]] 

EfiINT fdQCQPIES^n] QUEiilCE-fdx] Q DELETE^ [^,VFC3 

£lttiCH fdnrCQPIES-n) CDEyiCE-fdx[] QDELETE^ QWC^ 

[uqheader)~] vi erotect v 
nqerotect) 



QETION 



i f d ) r rUQHEADERH Vi 

( (f d, , fd2 fdn) j L \ i«M^»' U'Ll 



AUIOCONTINUE 



V 



£iIEGE fd 
lESMINATE 



J 



1-\1 
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Parameters: 



ADD 



defines a new device for 
device specified may be 
physical device. 



the spooler. The 
either a pseudo or a 



dev: 
pseudo-dev : 



specifies the nsime of a physical device. 

specifies the neune by which a pseudo device is 
known to the spooler . 



DELETE 



deletes the specified device (pseudo or 
physical) as the output spooling device after 
the current file is completed. 



ATTACH 



associates a predefined pseudo device 
predefined physical device. 



with 



DETACH 



disassociates the specified pseudo device from 
the specified physical device. Further output 
is prevented for the pseudo device. 



HOLD 



causes a file on the spool queue to be placed 
in a "hold" state until it is released. 



RELEASE 



causes a file on the spool queue to be 
released from the "hold" state and made 
available for output spooling. 



STATUS 



causes the status of the specified device 
(pseudo or physical) to be displayed to the 
system console. If the device parameter is 
not specified, this command displays to the 
system console the current status of each 
input, output and pseudo device. The message 
identifies the type of input device, names the 
device, and gives its current status. For 
output devices, the message informs the user 
which options are enabled. 



BACKWARD 



backspaces the spool output by the number of 
records specified by n. This pareuneter is 
invalid if the device is currently printing or 
punching. 



fd 



is the file detscriptor of the device used 
output spooling. 



for 



n 



is a decimal number indicating the number of 
records to skip backward or forward. 
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FORWARD 



CANCEL 



CONTINUE 



REWIND 



SUSPEND 



INQUIRE 



forward spaces the spool output file to be 
spooled out by the number of records specified 
by n. This pareuneter is invalid if the device 
is currently printing or punching. 

cancels the spool file currently being output 
to the device specified by fd. The current 
spool file is removed from the spool queue, 
and output spooling resumes with the next file 
on the queue. 



continues I/O to the specified fd. 



This 



parameter should be entered after I/O is 
paused because an I/O error occurred or the 
SUSPEND parameter was entered. This parameter 
is invalid if the device is currently printing 
or punching. 



restarts spooling a file, beginning 
header page. This pareimeter is 
output is currently active. 



with the 
invalid if 



suspends or pauses 
device after the 
has terminated I/O 
operator to change 



I/O to an output spool 

currently active spool file 

This parameter allows the 

r ibbon or paper between 



tasks. I/O 
parameter . 



is continued by the CONTINUE 



displays on the system console all 
currently on the spool queue and 
device assignments. 



f ilencunes 
the pseudo 



TASK= 



DEV= 



tttttttt specifies the task for which the 
spool queue is to be searched. An asterisk 
(*) and a dash (-) can be used to indicate 
generic task identifiers. These special 
characters are used in exactly the same way as 
in file selection with BACKUP. See Section 
3.4 for an explanation of how to use the 
special characters * and - to reduce the 
number of repetitious entries. 

pdv specifies the pseudo device for which the 
spool queue is checked for files being spooled 
to or from. 



ACCOUNT= 



LIST= 



aaaaa specifies a 1- to 5-digit number for 
which the spool queue is to be searched for 
spool files with the same account number. 

fd specifies the file or device to which the 
inquiry list is output. If this parameter is 
omitted, the inquiry list will go to the 
console. If fd cannot be found, a file will 
be allocated. 
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PRINT 



specif ies 
specif ied 
placed on 
parameter 
two. 



that the contents of 

by fd are to be printed 

the spool queue through 

and are spooled with a 



the file 

Files are 

the PRINT 

priority of 



COPIES= 



DEVICE= 



DELETE 



n is the number of copies to be printed or 
punched. If this parameter is not specified, 
the default is one copy. 

fd specifies the pseudo device to which the 
file (fd) is to be output. If fd is not 
specified, the output is sent to any available 
line printer or card punch device assigned to 
the spooler. If PRINT or PUNCH is specified 
to a device that does not support the 
requested function, the file is output in a 
form supported by the specified device; i.e., 
a PRINT to a card punch device results in 
punched output, and a PUNCH to a line printer 
results in printed output. 

If used with the PRINT or PUNCH parameters, 
this pareuneter deletes the user file after all 
copies have been printed or punched. Files 
that are automatically spooled by the system 
are deleted by default after they are printed 
or punched . 



NOTE 

Files with nonzero keys or files 
residing on a restricted disk 
without RW privileges for account 
cannot be deleted by the spooler 
and remain on the disk. 



VFC 



indicates that the specified file will be 
printed or punched using vertical forms 
control characters. 



PUNCH 



specifies that the contents of the file 
specified by fd are to be punched. Files are 
placed on the spool queue through the PUNCH 
parcimeter and are spooled with a priority of 
two. 



OPTION 



specifies the options in effect for the real 
or pseudo device specified by fd. Whenever 
two or more of the OPTION subparameters are 
used, they must be enclosed within 
parentheses . 
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fd 



NOHEADER 



HEADER 



PROTECT 



is a file descriptor that refers to a real or 
pseudo device. 



specifies that printing of the banner page 
to be suppressed. 



IS 



NOPROTECT 



NOBFF 



BFF 



NOTFF 



specifies that the banner page is to be 
printed. This parameter is the default. 

specifies that only those files that are 
either assigned to the specified device (fdi ) 
or specified in the DEVICE=fd statement In 
the PRINT or PUNCH parameter of the .SPL 
command can be output to the device. Files 
are not spooled to a device simply because it 
is available. 

enables a print or punch request to send data 
to any available pseudo device assigned to the 
spooler . 

specifies that no form feed will be sent at 
the end of a banner page. Text will begin 
immediately after the date line of the banner. 

specifies that a form feed will be sent to the 
printer at the end of the banner page. This 
parameter is the default. 



specifies that no form feed will 
the end of a printed file. 



be sent at 



TFF 



AUTOCONTINUE 



specifies that a form feed will be sent to the 
printer at the end of a printed file. This 
parcimeter is the default. 

causes OS/32 Spooler to periodically poll a 
device in the "not ready" state to see if it 
is ready to continue. When the device is 
ready, the spooler will automatically continue 
output to that device. 

NOAUTOCONTINUE causes OS/32 Spooler to cease output to a 

device in the "not ready" state until the user 
enters a CONTINUE command for that device. 
This parameter is the default. 



PURGE 



END 



removes a specified filename currently waiting 
to be spooled from the spool queue. 

allows the user to bring OS/32 Spooler to a 
gradual halt with all devices suspended after 
the current operation is completed. When all 
devices are suspended, OS/32 Spooler executes 
an SVC3 code instruction. 
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TERMINATE 



causes OS/32 Spooler to terminate all 
operations immediately with EOT 4. This 
command prevents deunage to the spool queue if 
the program is cancelled. 



Functional Detoiils: 

If the spooler is not active when a spool file is ready for 
output, the operator is informed that a filename was not entered 
on the queue. The file subsequently can be output by issuing the 
PRINT or PUNCH parameters from the system console. 



2.5 MEMORY REQUIREMENTS 

The spooler memory requirements are approximately 20kb plus: 



• 76 bytes for each message buffer 

• 180 bytes for each real device specified in the START command 

• 264 bytes for each I/O buffer 

If memory is not increased when the spooler is loaded, the 
additional memory designated by default (above the initial 20kb) 
is an additional 4kb. 

The spooler requires only one I/O buffer regardless of the number 
of spool devices. However, the spooler operates more efficiently 
with multiple II /O buffers. For every additional 264 bytes of 
memory available in the segment into which the task is loaded, 
the spooler creates another I/O buffer. If more than seven 
devices and more than ten message buffers are specified, the 
operator should load the spooler into a larger segment. If the 
number of real devices is not specified, the spooler will 
designate space in memory according to the number of logical 
units specified at link time. 

The space in memory taken by each pseudo device entry is related 



to the number of connected real devices, 
following formula: 



It is calculated by the 



(16-i-(8*n)) bytes 



where n is the number of connected real devices 



Excunple; 



LOAD .SPL, SPOOLER, 20 
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2.6 SPOOLER MESSAGES 

The following messages are output by the spooler. 

AULOCATE /ASSIGN ERROR ON PRINT QUEUE 

indicates that bad status was returned from SVC7 during 
either allocation or assignment of a spool queue file. 



BATCH NOT IN SYSTEM 

indicates that a /©SUBMIT control statement was processed 
during input spooling, but TASK.MTM was not loaded and 
started . 



BUFFER NOT AVAILABLE 

indicates that the free buffer into which the particular 
INQUIRE parameters would be passed is not available. The 
request is ignored, but can be repeated when a buffer is 
available. 



CURRENT OS DOES NOT SUPPORT THIS SPOOLER 

indicates that the OS was sysgened either without spool 
support or with SPL/32 support. 



DEVICE xxxx NOT DEFINED FOR OPTION COMMAND 

indicates that device xxxx specified in the OPTION 
parcimeter of the START or .SPL command is not a device 
name defined by the spooler at the time the OPTION 
parameter is processed. In the START command, specify 
the device xxxx as a pseudo or real device prior to 
specifying the OPTION parameter. In the .SPL command, 
use .SPL ADD xxxx prior to using the OPTION parameter. 



ERROR: xxxx ALREADY DEFINED 

indicates that the device specified has already been 
ADDed or ATTACHed. 



ERROR: xxxx DEVICE ACTIVE 

indicates that the device specified by a REWIND, 
CONTINUE, CANCEL, FORWARD or BACKWARD parameter was still 
spooling. 
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ERROR: 



XXXX DEVICE IS ALREAJDY SUSPENDED 



Indicates that a SUSPEND command was issued for a device 
on which a SUSPEND was already pending. The additional 
SUSPEND command is rejected. The device will stop at the 
end of the current file. 



ERROR: xxxx DEVICE IS IDLE 



indicates that the device was not spooling a file when 
the REWIND, CONTINUE, CANCEL, FORWARD or BACKWARD 
pareimeter was specified. 



ERROR: 



xxxx DEVICE IS NOT A REAL DEVICE 



indicates that the device xxxx specified is not a real 
device. The command entered requires a real device to be 
specified. 



ERROR: xxxx DEVICE QUIESED. RESTART DISALLOWED. 



indicates that an 
tried to restart 
a f i le . The command 



END command was issued and the user 
a device that was stopped at the end of 
is rejected. 



ERROR: 



xxxx IS NOT A PSEUDO -DEVICE 



indicates that the device xxxx specified is not a pseudo 
device. The command entered requires a pseudo device to 
be specified. 



ERROR: xxxx IS NOT CONNECTED TO ###tt 



indicates that the pseudo device xxxx 
DETACH parameter is not connected 



specified by the 
to the real device 



FILE filename NOT ON QUEUE 



indicates that the filen^ame specified with the PURGE, 
HOLD or RELEASE parsuneter is not on the spool queue. 



FILE filename SPOOLING 



indicates that the filename specified with the PURGE 
parameter is currently being spooled out. Determine the 
device to which the file is being spooled and use the 
CANCEL paraimeter to stop I/O and remove the filencune from 
the spool queue. 



48-031 FOO R02 



2-19 



INQUIRY LIST ASSIGN ERROR CODE-XX 

indicates that the list file for an INQUIRE conunand could 
not be assigned. The status returned from SVC7 is xx. 

INQUIRY LIST WRITE ERROR STATUS=yyyy 

indicates that an I/O error occurred while writing to the 
fd specified in the LIST= parauneter . The status returned 
from SVCI is yyyy. 

I INSUFFICIENT LUS DEFINED FOR START COMMANDS 

i indicates that the number of logical units available is 

i insufficient for the operation of the spooler as 

i specified by the START command. 



INSUFFICIENT MEMORY ALLOCATED FOR SPOOLER 

indicates that insufficient space is available for the 
operation of the spooler. Reload the spooler with a 
larger segment size increment field. 



INSUFFICIENT SPACE ALLOCATED FOR PSEUDO DEVICE TABLE 

indicates that insufficient space has been allocated for 
the pseudo device table. Reload the spooler with a 
larger segment increment field or increase the maximum 
number of pseudo devices to be supported with the 
MXPSEUDO parameter of the START command. 



INVALID fd 

indicates that the file descriptor specified with the 
.SPL PRINT or .SPL PUNCH command is a device, not a file, 
or that an invalid file descriptor is present. 



INVALID PARAMETER 

indicates that the parameter is invalid since it does not 
match any of the acceptable parameter inputs for the 
command . 



INVALID PARAMETER DELIMITER 

indicates that a pareimeter delimiter such as a comma or 
a parenthesis is missing. See the command format 
representation. 
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INVALID SYNTAX - voln : f ilename . ext/acct 

indiceites that an invalid file descriptor was specified 
with £1 .SPL PRINT or .SPL PUNCH command. 



I/O ERROR XXXX ON fd PLEASE CORRECT AND CONTINUE 

indiccites that a spool device returned a nonzero status 
(xxxx) , possibly because the printer is off-line or the 
card reader needs to be checked. The fd is the physical 
device. 



I/O ERROR xxxx ON LU #### fd i 

indiccites that an I/O error has occurred on LU ####; xxxx i 
is the status returned from SVCl. I 

I/O ERROR xxxx ON PRINT QUEUE FILE 

indiccites that SVCl returned bad status while writing to 
or reading from the print queue. xxxx is the status 
half word . 



NOTE 

If I/O error code 84XX appears 
during the OS/32 Spooler 
operation, please be aware that 
the error may be related to 
Network Printing using PENnet. 
See the PENnet System 
Administration Manual, Appendix 
9 for the PEN-NP Error Code 
Summary (84XX) . 



MAXIMUM RiSAL DEVICES EXCEEDED 



indicates that the number of real devices, as specified | 

by the START or .SPL, command, exceeds the maximum { 

alloweible aimount that was specified by the MAXDEVS I 

parameter. j 



MISSING /i) CONTROL CARD, FILE fd 

indiceites that the ending control card is missing on 
stacked input. The file being spooled to is the fd. 
Processing continues with the next job. 
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I NOT ADDED TO BATCH QUEUE 

I indicates that a file ispooled via /©SUBMIT was not put on 

I the batch queue. 

I NOT ENOUGH MEMORY FOR 1 I/O BUFFER PER DEVICE 

1 indicates that insufficient memory was designated to 

J allow an I/O buffer for each connected real device. The 

i spooler continues operation, but performance will be 

{ affected. 



OS/32 REVISION IS LESS THAN R06-02 

indicates that the version of OS/32 is earlier than 
R06-02. 



PERKIN-ELMER OS/32 SPOOLER 03-152 R03-00 

is an identification message that appears when OS/32 
Spooler starts its operation. 



PSEUDO -DEVICES EXCEEDS MAXIMUM 

indicates that the number of pseudo devices specified by 
the START or .SPL command exceeds the maximum allowable 
amount as specified by the MXPSEUDO parameter. 

QUEUE FILE NOT EMPTY - QORDER PARAMETER IGNORED 

indicates that reordering of queue items can only be 
accomplished when the queue is empty. Spool out the 
items that are presently on the spool queue. 



QUIESE IS PENDING 

indicates that the spooler is completing its operation. 
The REWIND or CANCEL command will be ignored since the 
spooler has already been instructed to end. 

WARNING: fd BAD LINE COUNT 

indicates that the limits of the file being spooled on 
device fd were exceeded following the FORWARD or BACKWARD 
parameters . 
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WARNING: fd INVALID FIRST CONTROL CARD 

indicates a syntax error on /§ starting control card. fd 
specifies the device name. 



WARNING: fd .SVC7 ERR=XX 

indicates that the device specified by fd could not be 
assigned by the spooler. The status returned by the SVC7 
call is XX. 



WARNING - NO OUTPUT DEVICES DEFINED 

indicates that no output spooling devices were defined by 
the START command. 



WARNING: XXXX RECORD LENGTH LESS THAN nnnn 

indicates that the record length defined for the real 
device xxxx is less than that defined for the associated 
pseudo device nnnn. 
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CHAPTER 3 
DISK BACKUP UTILITY 



3.1 GENERAL DESCRIPTION 

The Disk Backup Utility provides a fast method of saving files. 
Files can be transferred from disk-to-disk, disk-to -magnetic 
tape, tape-to-tape, or tape-to-disk. The starting parameters 
specified, dcite of back-up and names of the files backed up are 
listed. All files or selected files can be saved and restored. 
Files changed since a given date can be saved, and files on an 
output device can be replaced. Files on the input disk that have 
not been accessed since a specified date can be deleted after 
transferring them to the output device. Optionally, the data on 
the back-up device can be verified. 

The file types supported by the Disk Backup Utility are: 

• Indexed files 

• Contiguous files 

• Nonbuffered indexed files 

• Extendable contiguous files 

The primary difference between nonbuffered indexed files and 
indexed files is that in nonbuffered indexed files, data is moved 
directly betv^een the user's buffer and the disk, avoiding the 
central processing unit (CPU) overhead and system space memory 
requirements of buffered indexed files. As a result, each 
logical record starts on a physical sector boundary. Some unused 
space may exist between the logical records. 

Extendable contiguous files have essentially the same features as 
contiguous files, with one important exception: they are 
extendable up to the capacity limit of the disk. By making 
suitable choices of block sizes, random access performance of 
these files will be equivalent to that of contiguous files. 

See the OS/32 Application Level Progrsummer Reference Manual for 
a full explaneition of supported file types. 



48-031 FOO R02 3-1 



When transferring files from one disk to another, the Disk Backup 
Utility writes the files onto the destination disk in a 
contiguous manner as long as there are no bad sectors. This 
minimizes access time on the destination disk for indexed files 
and maximizes the amount of contiguous free space on the 
destination disk. The Disk Backup Utility can copy the files 
onto an empty destination disk or onto a disk that already 
contains files. 

The Disk Backup Utility performs the following functions: 

• Directly transfers files from one disk to another; the output 
disk serves as a back-up of the original. 

• Transfers files from an input disk to an intermediate magnetic 
tape device; the magnetic tapes are used as a back-up. 

• Appends files from an input disk to a magnetic tape containing 
previously backed up files; back-up can be requested to locate 
the end of previously backed up files on the tape or can be 
notified that the tape is already positioned for the current 
back-up operation. 

• Restores the data from the intermediate device to an output 
disk. 

• Verifies data copied during the back-up operation. 

• Verifies data that was copied during a previous execution of 
the utility. 

• Selectively dumps individual files from an input device to an 
output device. 

• Modifies the account numbers of files dumped from various 
accounts to one single account number during a disk-to-disk, 
disk-to-tape, or tape-to-disk transfer procedure. 

• Selectively restores files from tape to disk. 

• Selectively dumps files changed since a given time. 

• Deletes and replaces files on an output disk. 

• Copies files from an input tape to an output tape. 

• Displays the starting paroimeter specified, date of the Disk 
Backup Utility operation, and names (and other data) of the 
files backed up. 
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3.2 DISK BACKUP UTILITY MAGNETIC TAPE FORMAT 



When copying files onto magnetic tape, the output tape created by 
the Disk Backup Utility is in the following format: 



u 



n 



Volume header 



FIB 



Data 



E 
O 
F 



FIB 



Data 



u- 



Bytes : 




79 79 



n 



79 



n 



EOF EOV 



R 



Fields: 



Volume heeider is 80 bytes long and contains the following 

fields : 



Disk volume (volume name of input disk) 
Sequence number of tape, starting with 1 

on to the 



Number of blocks written 
preceding tape 



Size of buffer used to transfer data 
Revision and update number of back-up used 
Start options specified 
Date files backed up 



FIB (file 

information 

block) 



is 80 bytes long and provides information 
relative to the file. This pareimeter precedes 
the data of each file and contains the fields 
listed below. 



• Fileneime, extension and account number 

• File type 

• Keys 

• Logical record length 

• Number of records 
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• For indexed and nonbuffered indexed files, 
data block size and index block size 

• Date and time the file was created 

• Date and time the file was last changed 



Data 

EOF 
EOV 



indicates the disk block image of the data on 
the file. 

indicates end of file, 

indicates end of volume. 



NOTE 

If a very large buffer size is 
specified in the START command, 
the user must ensure that the tape 
has a sufficient length of trailer 
following the end of tape marker 
or the tape might run off the reel 
in an attempt to write the last 
record. 



For multivolume tapes (e.g., back-up using two tapes), an EOV is 
written on the first tape and the following message is displayed: 

PLEASE MOUNT TAPE NUMBER XX 

The volume header is written to the new tape and the remaining 
data is copied. The format is: 



TAPE 1 



Volume header 



FIB 



Data 



EOF 



FIB 



Data 



EOF 



EOV 



TAPE 2 




Remaining data i EOF I EOV 



3-4 
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3.3 DISK BACB:UP UTILITY REQUIREaiENTS 
The Disk Backup Utility requires: 



Approximately 25kb of memory, plus additional memory required 
for buffers 

A console device 

Two currently supported disk devices (for disk-to-disk 
operations); one currently supported disk and a magnetic tape 
device (for disk-to-tape operations); or two magnetic tape 
devices (for tape-to-tape operations) 

The version of the operating system with which the utility was 
released 



The Disk Backup Utility uses any additional memory available up 
to CTOP to dynamically increase its buffers in size and/or 
number. The aimount of memory available will therefore determine 
execution times, particularly when using magnetic tapes or 
contiguous files in back-up operations. 



3.4 OPERATING PROCEDURES 



The Disk Backup Utility executes as a privileged user task 
(u-task) and must be built as such by using Link. To run the 
Backup Utility from the MTM terminal, the user's account must be 
authorized with bare disk privileges and file account privileges. 



To reduce the possibility of errors in a data transfer 
magnetic tape, the recommended blocking factors are: 



to 



TAPE 
RECORDING 
DENSITY 

800 bpi 
1600 bpi 
6250 bpi 



BLOCKING 
FACTOR 

12 . 5kb 

25.0kb 

100 . Okb 



These blocking factors refer to the size of the blocks on tape 
and are controlled by the SIZE parameter of the START command. 
The default blocking factor used by the Backup Utility is 12kb. 
Using larger blocking factors than those recommended gains little 
additional storage space and results in an insignificant 
reduction in processing time. However, it does increase the 
probability of data transfer errors resulting in verify errors. 
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All disks used by the Disk Backup Utility must be marked on-line. 
The input disk can be marked on-line protected. When performing 
a back-up from a fixed disk to a removable disk, the fixed disk 
must always be marked on-line protected, provided the disks are 
on the same disk drive. If the input disk is on-line protected, 
users can read from, but not write to, any files on the volume. 
If the input disk is not protected, users can read from and write 
to all files on the volume. 

The Disk Backup Utility runs faster if the disks are marked on 
with the secondary directory option. If the secondary directory 
option is used on an output disk, an expansion factor should be 
used to ensure that no directory overflow occurs. (The default 
for the expansion factor is 100 files.) 

If the Disk Backup Utility attempts to copy a file that is 
currently assigned with write privileges, a message is output 
indicating the file cannot be copied. If option SKIP is in 
effect, the program skips to the next file without pausing. If 
option SKIP is not in effect, the Disk Backup Utility pauses 
after logging the message. At this point, the condition can be 
corrected by closing the file. When the utility is continued, it 
attempts to copy the same file. 

The integrity of all files is assumed. To guarantee successful 
execution of the program, either the output disk must be 
initialized prior to executing the Disk Backup Utility or, if 
files are to be restored in selective mode, the disk must be in 
a valid state. Initialization ensures that any bad sectors on 
the disk are avoided during the operation and that all file 
entries are removed from the disk directory. The integrity of a 
disk is ensured by executing the Fastchek Utility. 

The Disk Backup Utility does not save temporary, SYSTEM. DIR or 
PACKINFO.DIR files. All filenames are output to the list device 
as they are copied, which provides the operator with a log of the 
files contained on a given tape. 

Follow the procedure listed below to load and start the Disk 
Backup Utility. 

1. Load the Disk Backup Utility using the LOAD command as 
follows : 



LOAD BACKUP, n 



Where: 



n is the segment size increment, which is the 

maximum space available to the task (in 
kilobytes) . 
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Select back-up as the current task using the TASK command as 
follows : 



TASK BACKUP 

3. If an empty disk is used as an output device, it must be 
initialized using the Fastchek Utility prior to the back-up 
operation. See the OS/32 Fastchek Reference Manual for more 
details on this utility. 

4. Mark the disk used as input on-line, (optionally) protected 
using the MARK command as follows: 

MARK din : , ON 

or 
MARK dn : , ON , PROTECT 

5. Use the HABK command to mark the output disk on-line: 

MARK dn : , ON 

Using the secondary directory option (CD) to mark the input 
and output disks on-line will improve performance. The 
format of the commands follows: 

MARK dn: ,0N, ,CD 

or 
MARK dn : , ON , PROTECT , CD 

5. Start the Disk Backup Utility using the START command. 
Fileneimes are read until an end of data indicator (/* or ./) 
is found or until the maximum number of files that can be 
selected in one operation (40 if the size was not specified 
in the ST^JIT command) is found. 
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Format : 



START 



[,aiZE=nn[.dcl]] 



devn:| /devn: 

,1N=< >,QUT=^ >,LIST=fd 

(voln:) (voln:) 

(^,CQMMAND=fd3 Cend] [^ DELETE [yNODATECHECKl]] 

[,VEEIFY[/COUNT]]Qvq[/COUNT]J QafiORT^ CSKIP] C&CCOUNT*acct#] 

AEPEND 

Q SELECT- fd] 



(n\on/dd/YY\ 
,SlliCE=< >,hh:mm(jS3] 

(dd/mon/yy) 



,iQERR=< 



,£LOSE= 



SKIP 

QELETE 

MORT 

(EEWIND )' 



,<EQaiTION 
.(uQSEWIhJDj. 



[Tnemdate] 



[}&LXlNPUT=f d] ^,&LIQUTPUT-f d] 



Imon/dd/Y 
(dd/mon/yy) 



Qeeportonly] ,S£00L= 



X.ES 



(mon/dd/yy] ~| 

,AECHIVE='( )>,hh:nunQ333 



NOTE 

If the START command is entered without 
options, command entry will be 
interactive. A series of options may be 
entered. When a PROCESS command or an 
ENl) command is entered, the back-up 
operation executes with all of the 
options that were previously specified in 
effect. 



Parcuneters : 



IN- 



devn: is the device mnemonic of the input 
device from which data is copied. This 
device is assigned for sharable read-only 
(SRO) to logical unit 1 (lul). 

voln: is the volume name for the volume 
from which data is to be copied. voln: 
may only be used for disk volumes. 
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OUT= devn: is the device mnemonic of the 

output device to which data is copied. 
The utility assigns lu2 SRO for 
disk-to-disk copies? SRO for tape-to-disk 
copies; and exclusive read/write (ERW) for 
disk-to-tape copies. 

voln: is the volume naime for the volume 
to which data is to be copied, voln: may 
only be used for disk volumes. 

LIST- fd is the file descriptor of the 

device/file to which all list output is to 
be directed. The list device may be 
preassigned by the user to lu7. If 
entered in the START command, the list 
device is assigned for sharable write-only 
(SWO) to lu7. 

SIZE= nn specifies the size in kilobytes of the 

output tape buffer requested for 
disk-to-tape operation. If the output 
device is not a magnetic tape, this 
parameter may be specified but will be 
ignored. The default size is 13kb. nn is 
a decimal number with optional decimal 
places (dd); e.g., 16.50. 

COMMAND" fd is the input device from which 

additional paraimeters are to be taken. 
This allows the user to continue entering 
more arguments after the START parameter 
line is filled. COMMAND=fd may appear 
anywhere in the START parameter list. All 
parcuneters in the list are processed. 
After processing the START parameter list, 
additional pareuneters are read from the 
specified fd. The pareimeters are in the 
sciroe format as the START parameter list 
and are processed until the parameter END 
is encountered. 
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When input is from a command file, the 
PROCESS option may be used. The PROCESS 
option causes Backup to execute all 
options specified since the beginning of 
the command file, or since the previous 
PROCESS option. Multiple back-ups can be 
performed in one program run by using this 
option embedded within a command file. 



NOTE 

When command entry is 
interactive, an on-line help 
guide is available for all 
options of the Backup START 
command. For exeimple, when 
HELP SPOOL is entered, an 
explanation of the SPOOL 
option will appear on the 
terminal screen. 



END 



DELETE/ 
NODATECHECK 



causes Backup to stop scanning paraaneters 
within a command file or when being 
entered interactively. Anything specified 
after END in the command file or in the 
START command will be ignored. 

If DELETE is specified, the file on the 
output disk is deleted and replaced only 
if the last written date indicates it is 
an older version than the file on the 
input medium. The additional parameter 
NODATECHECK overrides this provision. 

If DELETE is specified and the file on the 
output disk is not an older version than 
the one on the input medium. Backup will 
display an error message and pause. 
Specification of DELETE and SKIP will 
cause the file to be skipped unless other 
errors are encountered. The list of 
backed-up files output during the Disk 
Backup Utility operation indicates if a 
file was deleted and replaced. If DELETE 
and SKIP are specified, files already 
existing on the output disk are deleted. 
Files are only skipped if other errors are 
encountered. 
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NOTE 



When the 
specif ied 
command , 
slower . 



DELETE 
with 



parameter is 
the START 



program operation is 



VERIFY 



COUNT 



indicates that data on the input and 
output devices is verified after all files 
have been copied. If the data does not 
verify, the nonverifying records from both 
files are output to the list device along 
with an error message. 

is a 1- to 5-digit number indicating the 
number of records in a file that must fail 
to verify before Backup will skip the 
remainder of the file. The number's value 
may be from 1 to 65,535. If omitted, 5 is 
the default. 



VO 



indicates data on the input and output 
devices is verified only. No copy 
operation is performed. Any records that 
do not verify are output to the list 
device. 



ABORT 



SKIP 



ACCOW[T= 



terminates a progreim if nonzero status is 
returned following an I/O operation or 
when allocating or assigning a file. If 
ABORT or SKIP is not specified, the task 
pauses . 

indicates that any files that cannot be 
successfully assigned on the output disk 
by the Disk Backup Utility are not 
transferred. The files are identified in 
an error message and the program skips to 
the next file instead of pausing. If any 
files were skipped during the copy 
operation, a message is generated and 
verify is not performed. If neither SKIP 
nor ABORT is specified, the task is 
paused . 

specifies the account number to which all 
files being backed up or restored are to 
be changed. Backup reads the file from 
the input device, changes the account 
number to the specified account number, 
and sends the file to the output device. 
The account number is a 1- to 5-digit 
number having a value from to 65,535. 
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SINCE= enables the user to b ck up or restore 

files changed since the specified date. 
mon/dd/yy is the name of the month, day 
and year. hh:mm:ss is the hour, minutes 
and seconds. The first three letters in 
the name of the month must be entered; the 
complete name can be entered. The month 
mnemonic should be followed by a slash and 
a two-digit number for the day. The day 
should be followed by a slash and a 
two-digit number for the year. The date 
can be entered with the month or day 
first. If the SINCE option is nbt 
specified, then no check is made of the 
date when a file was last changed. If the 
SINCE option is used in conjunction with 
the SELECT option, a file must have been 
changed since the given date and must 
match a SELECT entry in order to be backed 
up or restored. 

SELECT= fd selectively copies, and/or verifies 

files from input device to output device, 
fd is the file or device from which 
f ilencimes to be copied or verified are 
specified or entered. The Disk Backup 
Utility assigns this fd to lu5. 

The number of select entries that can be 
entered in an operation is limited by the 
segment size. All selected entries must 
reside in memory and use that area of 
memory between UTOP and CTOP. Memory used 
by select entries is not available to be 
used as I/O buffers. Each select file 
entry requires 14 bytes of memory. The 
SELECT option can be used in conjunction 
with the SINCE option, in which case the 
file must match a SELECT entry and must 
have been changed since the given date. 

The list of files to be backed up can be 
augmented by embedding the ! INCLUDE 
command or restricted by embedding the 
lEXCLUDE command within the select file. 
See examples of the use of embedded 
! INCLUDE and [EXCLUDE commands in the 
functional details section. 
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APPEND specifies that during a disk-to-magnetic 

tape back-up operation. Backup is notified 
that the magnetic tape output device 
contains back-up format data and that 
additional back-up files are to be added. 
Backup scans the tape for the EOV mark. 
It removes the mark and begins the current 
back-up operation. The EOV mark is 
rewritten after the last file is backed 
up. This option conflicts with the VERIFY 
option. 

POSITION specifies that during a disk-to-tape 

back-up operation. Backup is notified that 
the magnetic tape output device contains 
back-up format data, the files are to be 
appended to the tape, and the tape is 
already positioned at the EOV mark. The 
tape is backspaced one record, the EOV 
mark is removed, and the current back-up 
operation begins. The EOV mark is 
rewritten after the last file is backed 
up. This option conflicts with the VERIFY 
option. 

NOREWIND specifies that during a disk-to-tape 

back-up or restore operation. Backup is 
notified that the magnetic tape output 
device is positioned at the point where 
the current back-up operation is to begin. 
If writing to the tape, Backup will write 
a back-up format volume header followed by 
the files to be backed up. If Backup 
reads from the tape, the first record 
encountered on the tape must be a back-up 
format volume header. This option 
conflicts with the VERIFY option. 



CAUTION 

BECAUSE BACKUP ASSUMES THAT 
THE TAPE IS PREPOSITIONED WHEN 
THE POSITION OR NOREWIND 
PARAMETERS ARE ENTERED , 
CAUTION SHOULD BE EXERCISED 
WHEN USING THESE OPTIONS. IF 
THE TAPE IS NOT CORRECTLY 
POSITIONED, PREVIOUSLY 

BACKED-UP FILES COULD BE 
OVERWRITTEN AND LOST. 
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NEWDATE 



specifies that the date created and date 
last written for each backed-up file are 
updated to the current date and time on 
the output device. 



IOERR= 



is used to specify the desired 
tjie event of an I/O error. 



action in 



SKIP 



specifies that the errant file is 
skipped if an I/O error occurs. 



to be 



DELETE 



specifies that any portion of the output 
file backed up prior to the I/O error is 
to be deleted. 



ABORT 



specifies that the back-up task is 
aborted if an I/O error occurs. 



to be 



PAUSE 



specifies that the back-up task is 
paused if an I/O error occurs. 



to be 



ALTINPUT= 



specifies an alternate input device for 
multiple volume input tapes. If IN= 
specifies a disk device, this paraimeter is 
ignored . 



ALTOUTPUT= 



specifies an alternate output device for 
multiple volume output tapes. If OUT= 
specifies a disk device, this parameter is 
ignored. 



CLOSE- 



specifies the action to be taken upon 
closing an input and/or output tape. 



REWIND 



indicates that the tape is to be rewound 
upon closing. 



NOREWIND 



indicates that the tape 
rewound upon closing, 
default. 



is not to be 
This is the 



REPORTONLY 



specifies that the input device is to be 
read and a report generated based on the 
selection criteria, but that no back-up is 
to take place. 



SPOOL= 



specifies whether spool files are to be 
transferred from the input device if they 
are found there. A spool file has a 
commercial at sign (§) as the first 
character of its file neune. NO is the 
default . 
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ARCHIVE= 



enables the user to transfer files from a 
disk volume and then delete any 
transferred files that have not been 
accessed on or after the date specified by 
mon/dd/yy. Applies only to files that 
have been successfully transferred. The 
date can be entered with the month or day 
first. 



Functional Details: 

When started, the Disk Backup Utility prints this message: 



PERKIN-EOffiR OS/32 BACKUP 03-153 Rxx-yy 



where xx and yy 
Backup Utility. 



identify the revision level of the Disk 



If the SELECT=fd parameter is specified in 
statement, a message displaying the maximum numbe 
entries is output to the console and list device, 
(to be selected) are then read from the specif 
device (fd), until an end of data indicator 
found, or until the maximum number of 
selected in one operation is reached. More 
filename can be specified per 80-byte 



(/* 
files 
than 
input 



separating the fds with commas (,) or semicolons ( 



the START 
r of select 
F i lenames 
ied file or 
or ./) is 
that can be 
one select 
record by 
;). 



! INCLUDE allows a user to specify a file to be selected for 
transfer. Use of the keyword ! INCLUDE is optional within the 
select file. lEXCLUDE allows a user to prevent a file (or 
set of files) from being transferred. Only files selected 
for inclusion are checked for possible exclusion. 

The follov^ing is an example of a select file with an embedded 
lEXCLUDE. The processing of this file would result in the 
back-up of all files on accounts 118 and 119 that have an 
extension of .CAL. The ! EXCLUDE would prevent the back-up of 
any file v/ithin the specified group that has TMP as the first 
3 characters of the filename. 



-.CAL/ 118 

-.CAL/ 119 

lEXCLinDE TMP-.CAL/- 

/* 
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The next example of a select file contains both ! INCLUDE and 
lEXCLUDE. In this case, all files from account 118 with an 
extension of .043 are to be backed up. In addition, all 
files from account 119 are to be backed up, except for those 
files with an extension of .MEM, as specified by the 
lEXCLUDE. The exclusion of files with the .MEM extension is 
limited to those on account 119 because of the use of the 
! INCLUDE to make account 119 files members of the select 
file. 



-.043/118 

! INCLUDE -.-/119 

lEXCLUDE -.MEM/ 119 

/* 



In this final example of the use of the ! INCLUDE and lEXCLUDE 
commands, back-up is prevented for all files on accounts 73, 
118 and 119 that have Z as the first character of the 
filenaime and an extent ion of .FTN. 



j -.FTN/73 






i ! INCLUDE 


- 


.FTN/118 


i ! INCLUDE 


- 


.FTN/119 


i ! EXCLUDE 


Z 


-.FTN/- 


i /* 







When selecting files for a back-up or restore operation, it 
is possible to reduce the number of repetitive filename 
entries by using partial fileneunes. A hyphen (-) in the 
filenaime specifies that all files starting with the 
characters preceding the hyphen are to be be backed up or 
restored, subject to any restrictions specified in the 
extension or account number fields. The asterisk character 
(*) requests that all files with any character in the same 
position as the asterisk be selected. The characters * and 
- can be combined to delimit selected files. 

The following example selects for back-up or restore 
operations all files whose first five characters are CAL32. 



CAL32- 



The next example selects for back-up or restore operations 
all files nsimed TESTPROG with any extensions. 



TESTPROG- 
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The next exaimple selects for back-up or restore operations 
all files between five and eight characters in length whose 
first five characters are CAL32. 



CAL3 2 * * * 



The next excunple selects for back-up or restore operations 
all files with a filename containing six characters whose 
fifth and sixth characters are 32 and whose extension is OBJ. 



* * * * 3 2 . OBJ 



This final example selects for back-up or restore operations 
all files whose first three characters are CAL and whose 
sixth character is 1 with any extension. 



CAL**1~ 



End of task codes 



Upon successful completion of a Backup operation, the 
following message is printed: 



END OF TASK CODE = 



If there is an error in one of the START command paraimeters, 
the following message is logged on the system console and 
printed on the list device: 



END OF TASK CODE - 1 



If an error occurs during a verify operation, the following 
message is logged on the system console and printed on the 
list device: 



END OF TASK CODE = 2 
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If the user specified ABORT for SVC7 or I/O errors or if 
Backup fails an internal consistency check, the following 
message is logged on the system console and printed on the 
list device: 



I END OF TASK=10 



CAUTION 



WHEN RESTORING FILES TO DISK FROM 
MAGNETIC TAPE, ALWAYS REMOVE THE WRITE 
RING FROM THE TAPE PRIOR TO MOUNTING THE 
TAPE. THIS PRECLUDES THE POSSIBILITY OF 
INADVERTENTLY WRITING ON AN ALREADY 
BACKED-UP TAPE AND THE SUBSEQUENT LOSS OF 
FILES. 



When selectively restoring files from magnetic tape to disk, 
it is not necessary to read tapes prior to the tape 
containing the first file to be restored or verified. The 
program may be started with the first tape containing files 
to be restored or verified; whether that tape is the second, 
third, fourth, etc., tape of a set. Once the restore 
operation has begun, however, succeeding tapes must be 
mounted and read consecutively. 



Examples : 

This example of the START command copies DSC2: to DSCl: , 
verifies, aborts on errors and sends the listing to PR:. 



START, IN=DSC2: ,0UT=DSC1: , VERIFY, A, LIST=PR: 

This example preassigns list device to lu7, copies DSC2 to 
DSCl, and verifies. 

ASSIGN 7, PR: 

START, OUT=DSCl: , IN=DSC2: ,VE 

This example copies disk to tape, buffer size = 4.5kb, 
verifies, aborts on errors and sends a listing to PR:. 

START, IN=DSC1: ,0UT=MAG1: ,LIST=PR: , S IZ=4 . 5 , VE, A 
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This excimple copies tape to (3isk and aborts on errors. If 
filenames match, it restores only if the file from tape has 
a more recent date. 



START, IN=MAG1: ,0UT=DSC2: ,LIST=PR: ,A,VE,DEL 



This excunple verifies files from tape to disk but does not 
copy files. 



START, IN=MAG1: ,0UT=DSC2: rLI=PR: ,VO 



This excimple selectively backs up files from disk to tape and 
reads filenames from the console (CON:). 



START, IN=DSC5: ,0UT=MAG1: ,L=PR: , SEL=CON : 

This example copies all files from disk changed since March 
17, 1984, at 12; 30 to tape. 

START, COMMAND=CON: , IN=DSCl: 
BACK-UP >0UT=MAG1: ,LIST=PR: 
BACK-UP >SINCE=MAR/17/84, 12:30 
BACK-UP >VERI,END 

3.4.1 Multiple Disk Back-Up 

Backing up data from the fixed disk to the removable disk may 
require the use of multiple removable disks because the removable 
disk has much smaller storage capacity than the fixed disk. 



NOTE 

Fixed disk-to-removable disk back-up 
operations must be performed in a 
stand-alone environment with no other 
tasks running on the system. If other 
tasks are running while back-up is being 
performed, the system does not allow the 
user to mark the fixed disk off. 



When Backup has filled a disk, the following message is 
displayed : 
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PLEASE MARK OFF THE INPUT DISK 

PLEASE MARK OFF THE OUTPUT DISK AND MOUNT NEXT DISK VOLUME 

TASK PAUSED 

Follow this procedure to replace the removable disk and continue 
the back-up operation: 

1. Mark off the removable disk, using the MARK command. 

2. Mark off the fixed disk, using the MARK command. 

3 . Power down the dr ive . 

4. Remove the removable disk and mount the next removable disk 
to be used. 

5. Power up the drive. 

6. Mark the fixed disk on protect, using the MARK command. 

7. Mark the removable disk on, using the MARK command. 

8. Continue Backup, using the CONTINUE command. 

Backup will not split a file between two disks. If Backup cannot 
fit the entire file onto a disk, it will request that a new disk 
be mounted. Backup will then write the entire file onto the new 
disk. A file can be no larger than the total storcige capacity of 
the output disk. 

Disks that already have files residing on them can be used in 
back-up operations. Backup will not overwrite these files, but 
will use the remaining free space on the disk. 

3 . 5 MESSAGES 

DEVICE xxxx: MUST BE MARKED ON 

indicates that an attempt was made to start the Backup 
operation without first marking on xxxx device with the MARK 
command . 

ENTER SELECT FILE DESCRIPTORS (MAX=nnnn) 

indicates a program request ^'or filenames that are to be 
restored. The maximum nurnoeL ol ent-t les possible is nnnn. 
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EQUALS SIGN EXPECTED - xxxxxx 

indicates that a required equal sign has been omitted from 
parameter xxxxxx of the START command. 

ERROR (XX) ASSIGNING fd 

indicates that bad status was encountered while trying to 
assign to a device through the START command or while trying 
to allocate or assign a file. The returned SVC7 status is 
indicated by xx . 

INCORRECT NUMBER OF RECORDS TRANSFERRED 

indicates that the number of data blocks written on the 
previous tape during a multivolume disk-to-tape operation is 
not equal to the number of data blocks read during a 
tape-to-disk operation. 

INPUT DISK MUST BE MARKED ON "PROTECT" 

indicates that in an attempt to back up data from a fixed 
disk of a 10Mb disk to a removable disk of the saune pack, the 
input was not marked on-line with a protected status. Backup 
pauses. The input disk must be marked off and then marked on 
protected, and the task continued. 

I/O ERROR (yyyy) ON LU xx-fd 

indicates that an I/O error was encountered during an SVCl 
read or write operation from a device or file. The lu is xx; 
yyyy is the error status. 

INPUT TAPE SEQ. ERROR: EXPECTING- XX MOUNTED-yy 

indicates that the currently mounted tape does not have the 
expected sequence number . The sequence number on the volume 
label of the currently mounted tape is displayed. 

INSUFFICIENT MEMORY AVAILABLE 

indicates that there is not enough memory available. Reload 
the progrsim into a larger segment and restart. 

INTERNAL FAILURE: ADDRESS=aaaaaa CODE=xxxx 

indicates a failure in one of Backup's internal consistency 
checks. Please report this to your local Perkin-Elmer 
analyst after taking a dump of impure task space. 
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I 



I INVALID DATE SPECIFICATION 

I indicates invalid day, year or month in the START command. 



) 



INVALID PARAMETER - XXXXXXXX 

indicates an error in one of the START parameters? xxxxxxxx 
is the parajneter in error. 

INVALID PARAMETER DELIMITER 

indicates syntax error in START command. 

INVALID SELECT FILE DESCRIPTOR-f n 
! indicates invalid syntax in filename for selective restore. 

! INVALID SELECT KEYWORD - XXXXXX 

! indicates a keyword other than ! INCLUDE or SEXCLUDE was found 
I in the select file record. 

INVALID TAPE VOLUME xxxx, EXPECTING XXXX 

indicates that the currently mounted multivolume tape has not 
been created from the same input disk. 

I LOGICAL RECORD CANNOT FIT INTO OUTPUT BLOCK SIZE FOR fn 

I indicates that the output block size is too small for the 
I logical record. 

i NO FILES ON DISK - dev: 



indicates that no directory was found on dev: disk. 

NON-VERIFY:FILE fn LOGICAL UNIT x: RECORD NUMBER xxxx 
indicates that data in the file fn does not verify. 

OPTION VERIFY 

indicates that the program started a verify routine. 
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OS/32 Rxx-yy OR HIGHER IS REQUIRED 

indicates that Backup is being run on an incompatible 
operating system. Revision xx-yy or higher of the operating 
system is required. 

OUTPUT DEVICE IS PROTECTED 

indicates that the desired operation cannot proceed because 
the output device is protected. 

PARAMETER ALREADY SPECIFIED 

indicates that a parameter of the START command was entered 
more than once. 



PARAMETER IN CONFLICT - xxxxxxxx 

indicates that two parameters are in conflict; i.e , the 
APPEND, POSITION or NOREWIND options were used alonq with the 
VERIFY option. 

PERKIN-ELMER OS/32 BACKUP 03-153 Rxx-yy 

indicates that the program is operational. The progrcim's 
revision level is xx; yy is the update level within the 
revision. 



PLEASE MARK OFF THE INPUT DISC 

indicates that Backup has filled an output disk during a 
multiple disk back-up operation. Follow the procedure for 
multiple disk back-up detailed above. 

PLEASE MARK OFF THE OUTPUT DISC AND MOUNT NEXT DISC VOLUME 

indicates that the EOV was reached before all files were 
copied and another volume must be mounted. 

PLEASE MOUNT TAPE NUMBER xx 

indicates that the end of a tape was reached before all files 
were copied or verified, or the tape currently mounted is not 
the first tape at the start of the verify routine. 



I 
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REQUIRED PARAMETER MISSING - XXXXXXXX 

indicates a required parameter, such as IN=, OUT= or LIST=, 
is not present. xxxxxxxx gives the expected parameter. 

SELECT FILES EXCEED MAXIMUM 

indicates that the maximum number of files allowed during 
selective restore/verify was exceeded. 



SELECT FILES NOT COPIED 
fn 



indicates that specified files were not found on the disk or 
tape after a selective restore operation. All filensunes not 
processed are listed following this message. 



SELECT FILES NOT VERIFIED 
fn 



indicates that the specified files were not found on the disk 
or tape after a selective verify operation. The filenames 
follow this message. 
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CHAPTER 4 
OS/32 ACCOUNTING REPORTING UTILITY 



4.1 INTRODUCTION 

The Accounting Reporting Utility processes accounting data 
collected at data collection time and generates reports or 
archival files through operator commands. The Accounting 
Reporting Utility provides selection of the following: 

• Collected accounting data to be processed (input files) 

• Account numbers on which the reports or archives are generated 

• The time period in Which the accounting data was collected for 
the requested account numbers 

• Disk devices with which additional file usage information is 
generated 

• Cost factors used to calculate charges for system and disk 
usage 

• Generation of reports 

• Generation of archives 



Collected accounting data to be processed can consist of these 
input files amd devices: 

• Accounting treuisaction files (ATFs) 

• Authorized user file (AUF) 

• Archival files 

• Disk devices 



See Figure 4-1 for an illustration of the Accounting Reporting 
Utility process. 
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Figure 4-1 The Accounting Reporting Utility Process 



Account numbers specify each account for which data is read from 
the input files. The time period selects the starting and ending 
dates for which data is read from the input files. Disk devices 
are the disk volumes to be scanned for file usage data. Charge 
amounts specify the charge per unit of usage that each customer 
is charged. 



4-2 



48-031 FOO R02 



4.1.1 Data Collection 

Data collection is performed by the operating system and 
multi-terminal monitor (MTM) through counting, collecting and 
logging routines, which together collect and store the accounting 
information in a user -specified disk file. For systems with MTM, 
see the OS/32 Multi-Terminal Monitor (MTM) System Planning and 
Operator Reference Manual for the data collection start 
procedure. 

4.1.2 Starting the Data Collection for an Operating System 
Without Multi-Terminal Monitor (MTM) 

First, an operating system must have been generated (sysgened) 
with accounting support. Next, the accounting facility data 
collection program (AFDCP) , a "dummy MTM", can be loaded and 
started in the following manner . 

LOAD .MTM, AFDCP 
TASK .MTM 
START, ATF=fd 

where fd is the file descriptor of the ATF, 

The AFDCP is able to accept two MTM commands, QUIESCE and ATF. 
The format of these commands is as follows: 



.MTM QillESCE 
and 

.MTM ATF fd 

Where: 



QUIESCE terminates Al'DCP . 

ATF changes the accounting transaction file. The 

current ATF is closed and a new ATF is 
allocated (if necessary) and assigned. 
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4-2 COMPILING, ESTABLISHING AND STARTING THE ACCOUNTING 
REPORTING UTILITY 

The command sequences below can be used as exeunples for creating 
an Accounting Reporting Utility task. Certain pareuneters will 
vary depending upon system configuration and library file 
location and names. 

The following commands compile the Accounting Reporting Utility 
FORTRAN source: 



LOAD F7D, .BGpTASK.BG 
ASSIGN l,ACCTF.FTN,SRO 
XALLOCATE ACCTF . OBJ , IN 
ASSIGN 2, ACCTF. OB J 
ASSIGN 3, CON: 
ASSIGN 6,F7D.ERR/S 
START , HOLL , BATCH , NRXT 

Program common data areas are defined in the file ACCTF. FTN. 
This file is copied into each FORTRAN module through the FORTRAN 
INCLUDE option and must be on the default volume. The following 
commands assemble the assembly language modules: 

LOAD CAL32;TASK,BG 
XALLOCATE ACCTC . OBJ , IN 
ASSIGN 1, ACCTC. CAL,SRO 
ASSIGN 2, ACCTC. OB J 
ASSIGN 3, CON: 
TEMPFILE 4, IN, 80 
TEMPFILE 5, IN, 256 
START , CROSS , BATCH , SQUEZ=99 

The following commands establish the Accounting Reporting Utility 
as a task: 



LOAD LINK, .B 

START 

LOG CON: 

TITLE ACCT 

ESTABLISH TASK 

INCLUDE ACCTF. OB J 

INCLUDE ACCTC. OB J 

LIBRARY F7RTL/S 

BUILD ACCT 

MAP CON: 

END 
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! LOAD I 



4.2.1 LOAD c:onunand 

The LOAD conuuand loads the Accounting Reporting Utility into 
memory . 

Format : 



LOAD ACCT 



Functional Details: 

The MTM account under which the Accounting Reporting Utility is 
invoked has to be established with the no key check and file 
access by account number privileges, if OPTION AUF=fd is going to 
be specified. See th6 OPTION command in Section 4.3.3 for 
further information. 

If disk volumes are to be scanned for current file allocation to 
be included in the report, the MTM account has to be established 
with bare disk assignment privilege. 
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I START I 

4.2.2 START CotnmeUid 

The START commeind starts the Accounting Reporting Utility. 

Format : 

START [,COMMAND=fdi] QLlST=fd23 [^LQG'fdJ] 

Parameters: 



COMMAND" 



LIST= 



LOG= 



fdi specifies the input device from which 
commands are to be entered. If this parameter 
is omitted, the default is CON:. If the 
command input device is interactive and the 
LOG parameter is omitted, all commands entered 
and error messages generated are sent to the 
command input device. 

fda specifies the output device to which 
reports are sent. If this parameter is 
omitted, the default is PR:. If the list 
output device is a disk file, it must have 
been previously allocated. The list output 
file can be changed by the REPORT command. 

fd3 specifies the output device to which all 
commands entered and error messages generated 
are recorded. If this parameter is omitted 
and the command input device is interactive, 
all commands entered and error messages 
generated are sent to the command input 
device. If this parameter is omitted and the 
command input device is batch, all commands 
entered and error messages generated are sent 
to the default log device (PR:). If the log 
output device is a disk file, it must have 
been previously allocated. 



Messages : 



INVALID START OPTION 

The command, list or log device entered as a start option 
is invalid. 
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COMMAND DEVICE ERROR 

The syntax of the device or file entered as a start 
option is invalid. 



LIST DEVICE ERROR 

The device or file specified as the list device is 
invalid. 



LOG DEVICE ERROR 

The device or file specified as the log device is 
invalid . 



DUPLICATE START OPTION 

One of the start options was entered more than once. 

SYNTAX ERROR 

The syntax of the start options is invalid. 



COMMAND 
UNABLE TO ASSIGN LIST 

LOG 

The device or file specified as a start option cannot 
be assigned. 
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4.3 ACCOUNTING REPORTING UTILITY COMMANDS 

The following commands, listed in their logical order of use, 
execute the Accounting Reporting Utility: 



• GET 

• SELECT 

• OPTION 

• CHARGE 

• REPORT 

• SAVE 

• PAUSE 

• END 

All commands except PAUSE and END can be continued on succeeding 
lines by entering a comma after the last parameter specified on 
a line. A command is terminated by a carriage return (CR) or end 
of record. 

The temporary volume must be mounted and on-line to the system 
during execution of the Accounting Reporting Utility. The 
program requires single and double precision floating point 
support. Messages for these commands are presented in Section 
4.5. 
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GET I 



4.3.1 GET Command 



The GET command specifies the 
collected accounting data and the 
the Accounting Reporting Utility. 



input files containing the 
disk volumes to be processed by 



Format: 



GET 



AIE.-' 



raECHIVE=< 



,D1SC=< 



fd- 



((fdi, 



fd 



2 Q . . . , f d n^] ) ) _ 



fd, 



(fdi ,f da [,..., fdn]) )_ 
vol id. 



(volidi rvolida [",... , volidn") ) 



Parameters: 



ATF = 



specifies the file descriptors of the ATFs 
created by the MTM START command or .MTM 
be processed by the Accounting 
Utility. The ATF input files 
accounting data collected at data 
time. If more than one fd is 
parentheses must be used. When 



commands to 
Reporting 
contain the 
collection 
specif iedr 



this parauneter is specified, all ATFs are 
assigned with exclusive read/write (ERW) 
access privileges. The maximum number of ATF 
and archival files that can be specified in 
the GET command is 10. 



NOTE 

Once assigned to data collection, 
the ATFs cannot be simultaneously 
used by the Accounting Reporting 
Utility. 
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ARCHIVE= 



DISC= 



specifies the archival files (disk or tape) 
created by a previous execution of the 
Accounting Reporting Utility through the SAVE 
conunand. These files are to be processed by 
the Accounting Reporting Utility. If more 
than one fd is specified, parentheses must be 
used. The maximum number of fds that can be 
specified by the GET command, including ATF 
and archival files, is 10. When this 
parameter is specified, all archival files are 
assigned with ERW access privileges. 

specifies the disk volumes to be scanned for 
current file allocation data. If a specified 
volume is not on-line, a message requesting 
that volume to be marked on-line is displayed. 
The maximum number of volumes that can be 
specified is 10. 



Functional Details: 

These parameters can be specified separately by entering multiple 
GET commands or combined in one GET command. The GET command 
must be entered before the REPORT or SAVE commands. If a 
subsequent GET command is entered after the REPORT or SAVE 
commands are entered, the files specified by the previous GET 
command are no longer input files to the Accounting Reporting 
Utility. The fds specified by the subsequent GET command are the 
new input files to the Accounting Reporting Utility. 
Specification of the DISC paraimeter includes all files that were 
active during the report period. This data is copied to a 
temporary file to be included in the generation of the final 
report. 



Examples : 



GE ATF=M67A:ATFG4.E 



GE ATF=(M300:ATF01.B,M3O0:ATF02.B) , 
ARC=MAG4 : , 
DI=(M300,M301,M67B) 
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I SELECT 



4.3.2 SELECT Commauid 

The SELECT command selects from the input files specified by the 
GET command a particular subset of accounting data to be 
processed by the Accounting Reporting Utility. This subset of 
accounting data is selected by specifying account numbers and a 
time period for which the report or archive is to be generated. 



Format: 



SELECT 



EROM^i 



(mon/dd/yy \ 



imon/dd/yy ) 
dd/mon/yy ; 



( dd/mon/yy )_ 

(actnoi [^-actnonj ) 
,ACCOUNT=S (actnoi ,actno2 Q . . . , actnonj ) 

MX 



Parameters: 



FROM= 



T0= 



mon/dd/yy or dd/mon/yy identifies the starting 
date of the particular time period for which 
a subset of accounting data is selected. All 
records containing a date within the specified 
starting and ending dates are to be processed 
by the Accounting Reporting Utility. If this 
parsuneter is omitted, the time period begins 
with the earliest date recorded in the ATFs or 
archival files. The month must be specified 
by at least three alphabetic characters. 



mon/dd/yy 
date of 



or dd/mon/yy specifies the ending 
the particular time period for which 
a subset of accounting data is selected. All 
records containing a date within the specified 
starting and ending dates are to be processed 
by the Accounting Reporting Utility. If this 
parameter is omitted, the time period ends 
with the latest date recorded in the ATFs or 
archival files. The month must be specified 
by at least three alphabetic characters. 
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ACCOUNT= 



actno specifies the account numbers within the 
specified time period for which accounting 
data is to be processed by the Accounting 
Reporting Utility. Account numbers can be 
specified as a list or as a range and must be 
enclosed within parentheses. The account 
numbers that can be specified by the SELiECT 
command range from to 65,535 (excluding 
255). Account number 255 is reserved for the 
AUF . Account number is for system files and 
is the default for all operator commands. 



ALL 



specifies that records for all account numbers 
within the specified time period are processed 
by the Accounting Reporting Utility. If the 
ACCOUNT parameter is omitted, the default is 
all account numbers that were recorded in the 
input files within the specified time period. 



Functional Details: 



Multiple reports can be generated from the particular subset of 
accounting data processed by the Accounting Reporting Utility. 
If the SELECT command is not specified, all data in the files and 
devices specified by the GET command are processed by the 
Accounting Reporting Utility. If the SELECT command is entered, 
only records containing dates and account numbers specified by 
the SELECT command are processed from the input files. If a 
subsequent SELECT command is entered after the REPORT and SAVE 
commands are entered, the account numbers and dates specified by 
the previous SELECT command are no longer selected to be 
processed by the Accounting Reporting Utility. The account 
numbers and dates specified by the subsequent SELECT command are 

be processed by the Accounting 



the new 
Reporting 



account 
Utility. 



numbers to 



Examples 



SEL FR=SEP/l/82 ,TO=OCT/l/82 , 
AC=ALL 



SEL FR=AUG/l/82 
SEL TO=DEC/l/82 
SEL AC=( 100-150) 



SEL FR-JUN/15/82 , 
TO=AUG/15/82 , 
AC= (45 , 107 , 145 , 118 , 155 ) 
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OPTION I 



4.3.3 OPTION Coromoind 

The OPTION conunand includes any of these optional features in the 
generated report: 



• AUF information 

• Date 

• Message 

• Signature 

• Titles 

Format : 



OPTION 



fd 



MJiE." 



' date ' 



,DAIE=< 



message' 
, MESSAGE =\ fd 



-\~:l 



r SIGNATURE 



'title' 
,3:ACC0UNT=^ fd 

'title' 
, 3SXSUSE= \ f d 



title' 
,HEADER=\ fd 

(•title'" 
,XSiJMMARY='\ fd 
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Parameters: 



AUF= 



fd is the file descriptor of the AUF, created 
by the account utility, that is to be included 
as an input file to the Accounting Reporting 
Utility. The user identifier (user id), group 
account number, total signon time, and user 
time left are included in the generated report 
for each account. When this parameter is 
specified, the AUF is assigned with shared 
read only (SRO) access privileges. If this 
pareimeter is omitted, the accounting data in 
the AUF is not included in the generated 
report. 

* closes the previously assigned AUF, 
excluding it as an input file to the 
Accounting Reporting Utility. 



DATE- 



date is the date to be included as the report 
date in the generated report. The date is a 
1- to 20 -character alphanumeric string. If 
this parameter is omitted, the current date is 
included . 



* specifies that the current date 
included in the generated report. 



IS 



to be 



MESSAGE= 



SIGNATURE- 



message is a 1- to 80-character alphanumeric 
string specifying a message to be included at 
the end of the individual account or account 
summary report. If this parameter is omitted, 
no message is included. 

fd is the file descriptor containing the 
message to be included at the end of the 
individual account or account summary report. 

* specifies that the previously specified 
message is not to be repeated at the end of 
the individual account or account summary 
report. 

name is a 1- to 40-character alphanumeric 
string specifying a name to be included in the 
generated report. If this parameter is 
omitted, no signature is output. 

* specifies that the previously specified name 
is not to be included in the generated report. 
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HEADER- 



title is a 1- to 80-character alphanumeric 
string specifying the main title to be 
included at the top of each report. If this 
parameter is omitted, the main title 
PERKIN-EL24ER OS/32 ACCOUNTING REPORT is the 
default . 



fd is the file descriptor containing the main 
title to be included at the top of each 
report. 

* specifies that the main title to be included 
at the top of each report is: 



PERKIN-ELMER OS/32 ACCOUNTING REPORT 



TACCOUNT= 



title is a 1- to 80-character alphanumeric 
string specifying the subtitle to be included 
at the beginning of each report generated for 
individual accounts. If this parameter is 
omitted, the subtitle ACCOUNT NUMBER: actno 
is the default. 



fd is the file descriptor containing the 
subtitle to be included at the beginning of 
each report generated for individual accounts. 

* specifies that the subtitle to be included 
in the beginning of each report generated for 
individual accounts is: 



ACCOUNT NUMBER; 



actno 



where actno is an individual account number 
for which the report is being generated. 



TSUMMARY= 



title is a 1- to 80-character alphanumeric 
string specifying the subtitle to be included 
at the beginning of each report generated for 
account summaries. If this parameter is 
omitted, the subtitle ACCOUNT SUMMARY REPORT 
is the default. 



fd is the file descriptor containing the 
subtitle to be included at the beginning of 
each report generated for account summaries. 
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* specifies that the subtitle to be included 
at the beginning of each report generated for 
account sununaries is: 



ACCOUNT SUMMARY REPORT 



TSYSUSE= title is a 1- to 80-character alphanumeric 

string specifying the subtitle to be included 
at the beginning of each report generated for 
system usage sununaries. 

If this parameter is omitted, the subtitle 
SYSTEM SUMMARY REPORT is the default. 

fd is the file descriptor containing the 

subtitle to be included at the beginning of 

each report generated for system usage 
summaries. 

* specifies that the subtitle to be included 
in the beginning of each report generated for 
system usage summaries is: 



SYSTEM SUMMARY REPORT 



Functional Details: 

If an OPTION parameter is entered more than once, the last 
parameters specified are used. If this command is entered with 
a syntax error, the default values are used. If the parsimeters 
exceed one line, close the last parameter's text on the first 
line with a single quotation mark followed by a comma and a OR. 
Continue the pareiroeter's text on the next line with a single 
quotation mark followed by text and a closing single quotation 
mark. 



Examples : 



OP AUF=AUF.20C,DA=*,MES=MSGS.ACT, 
SIG='M.PICKELL' ,HE=*,TA=* 



OP AUF=*,DA=' 10/15/79' ,MES= 'DEPARTMENT NO. 6052', 

SIG=' I .SCHIEL' ,HE='SUTTON CO. ACCOUNTING REPORT', 
TSU=* 
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4.3.4 CHARGE Contmeind 

The CHARGE command specifies thei charge factors used to calculate 
charges for system usage. This command is used in conjunction 
with the REPORT command. 



Format: 



CHARGE 



Q/dlrs . cts ,D/dlrs . cts , A/dlr s . cts 
CEUTIME= < NULL 

dlrs.cts 
classno^ /dlrs.cts Q . . . ,classnOn/dlrs .cts[] 
,-LQCOUNT=^ NULI. 

dlrs. cts 
[i/dlrs.ctar] QE/dlrs.cts^ Qa/dlrs.cts] 
,lffiMORY=^ NULL 

dlrs - cts 
HULL )"" 



,13ECTORS=< 



[dlrs.cts;.. 



Parameters: 



CPUTIME= 



0/dlrs.cts specifies the charge in dollars and 
cents (7 digits) for each second of operating 
system central processing unit (CPU) time 
used. If this pareuneter is omitted, no 
charges are calculated or included in the 
generated reporL. Flowever, the time used is 
included. 



U/dlrs.cts specifies the charge in 
cents for each second of user CPU 
If this parameter is omitted, no 
calculated or included in the 
report. However, the time used is 



dollars and 
time used, 
charges are 
generated 
included. 
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A/dlrs.cts specifies the charge in dollars and 
cents for each second of user auxiliary 
processing unit (APU) time used. If this 
pareimeter is omitted, no charges are 
calculated or included in the generated 
report. However, the time used is included. 
This applies to users of Model 3200MPS 
Systems . 



NQLXj specifies that no charges 
used are to be included in 
report . 



for CPU time 
the generated 



IOCOUNT= 



dlrs.cts specifies the charge in dollars and 
cents (7 digits) for each second of operating 
system, user CPU time and, for Model 3200MPS 
Systems, user APU time used. 

classno/dlrs.cts specifies the charge in 
dollars and cents (7 digits) for each I/O 
transfer executed for up to 10 device or file 
classes. If this parameter is omitted, no 
charges are calculated or included in the 
generated report. However, the total count of 
I/O transfers executed for all device or file 
classes is included. The maximum number of 
I/O classes that is currently processed by the 
Accounting Reporting Utility is 10. 

NULL specifies that no charges for counts of 
I/O transfers are to be included in the 
generated report. 

dlrs.cts specifies the charge in dollars and 
cents (7 digits) for each I/O transfer 
executed by the device or file classes in the 
system. 



MEMORY- 



I /dlrs.cts specifies the charge in dollars and 
cents (7 digits) for each .251cb segment of 
impure memory used. If this parauneter is 
omitted, no charges are calculated or included 
in the generated report. However, the number 
of .25kb segments of impure memory used is 
included . 



P/dlrs.cts specifies the charge in dollars and 
cents (7 digits) for each .25k;b segment of 
pure memory used. If this parameter is 
omitted, no charges are calculated or included 
in the generated report. However, the number 
of .25kb segments of pure memory used is 
included . 
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S/dlrs.cts specifies the charge in dollars and 
cents (7 digits) for each .25kb segment of 
system space used. If this parameter is 
omitted, no charges are calculated or included 
in the generated report. However, the number 
of .25kb segments of system space used is 
included. 

NULL specifies that no charges for the number 
of .25kb segments of impure memory, pure 
memory or system space used are to be included 
in the generated report. 

dlrs.cts specifies the charge in dollars and 
cents (7 digits) for each .25kb segment of 
impure memory, pure memory and system space 
used. 



SECTORS- 



NULL specifies that no charges or number of 
days on which disk sectors were used is to be 
included in the generated report. 



Examples : 



dlrs.cts specifies the charge in dollars and 
cents (7 digits) for each day disk sectors 
were used. If a sector is used for only a 
part of a day, sector usage is charged at the 
full day rate. 



CHA CP=O/01.50,U/0.75,A/0.60 

IOC=0/1.00, 1/1. 10,2/1. 15,3/1.25, 
MEM= I /O . 90 , P/1 . 15 , S/ 1 . 50 , 
SEC=1.05 



CHA CP=1.15, 
IOC=1.00, 
MEM=1.00 

CHA SEC=NDLL 
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4.3.5 REPORT Command 

The REPORT command generates reports from the accounting data 
specified by the GET and SELECT commands and sends the reports to 
the list device specified in the START or REPORT command. 



Format ; 



REPORT [LIST=fdJ 



,ZROM= 



Tmon/dd/yy ) 



,IQ= 



(dd/mon/yy) _ 

(actnoi [[-actnonj ) 
,&CCOUNT=S (actnoi , actno2 Q . . . ,actnonJ ) 

ALL 
actnoi Q-actnon] 
,SiJMMARY=<(^actnoi factnogQ • . . ,actno,^) 

ALL 

Q axausE] 



(mon/dd/yy^ 
(.dd/mon/yy )_ 



Parameters: 



LIST= 



FROM= 



fd specifies the file descriptor to which the 
generated report is sent. If the specified fd 
is a disk file, the file must have been 
previously allocated. If this paraimeter is 
omitted, PR: is the default device. 

mon/dd/yy or dd/mon/yy specifies the starting 
date for the report period. If the SELECT 
command was entered, the date must be within 
the time period specified by the SELECT 
command. If this pareimeter is omitted, the 
starting date specified by the SELECT command 
or the earliest date in the input files is 
used. The month must be specified by at least 
three alphabetic characters. 
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TO= 



ACCOUNT= 



mon/dd/yy or dd/tnon/yy specifies the ending 
date for the report period. If the SELECT 
command was entered, the date must be within 
the time period specified in the SELECT 
command. If this parameter is omitted, the 
ending date specified by the SELECT command or 
the latest date in the input files is used. 
The month must be specified by at least three 
alphabetic characters. 



actno specific 
individual a 
generated. Ac 
a list or as 
must be enclos 
account numbe 
specified by t 
range collecte* 



s the account numbers for which 
ccounting reports are to be 
count numbers can be entered as 
a range and, in both instances, 
ed within parentheses. These 
rs must be within the range 
he SELECT command or within the 
d in the input files. 



ALL specifies individual accounting reports 
are to be generated for all account numbers 
specified by the SELECT command or collected 
in the input files. If the ACCOUNT= parameter 
is omitted, AI^L is the default. 



SUMMARY= 



SYSUSE 



actno specifies the account numbers for which 

summary reports are to be generated. These 

account numbers must be within the range 
specified by the SELECT command. 

ALL specifies all accounts are to be included 
in one account summary report. The account 
numbers included in the summary report are 
those specified by the SELECT command or all 
accounts collected in the input files (if the 
SELECT command was not entered) . If this 
parameter is omitted, no account summary 
reports are generated. 



specifies that a system summary report 
be generated. 



is to 



Functional Details: 

All parameters in a REPORT command that are required to generate 
a set of reports must be entered in one REPORT command. If the 
REPORT command is entered and no parameters are specified, the 
defaults are: ACCOUNT=ALL and the list device specified in a 
previous REPORT or START command. Any number of reports can be 
generated from input files by specifying various date periods and 
account numbers. 



If the parameters exceed one 
character on that line and 
the next line. 



line, enter 
continue the 



a comma 
remaining 



as the last 
paraimeters on 
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Examples : 



REP LI=PR1: ,FR=JUL/15/82,TO=OCT/15/82, 
AC= (45, 32, 100, 147, 121) 



REP LI=PR: ,FR=SEP/l/82,TO=OCT/l/82, 
SUM=118-122 



REP LI =M67B : SYSACT . 40E , FROM= JAN/ 1/82 , 
TO=MAR/31/82,SYSUSE 



REPORT 



! Sample Reports : 

I Examples of a system summary report, an account summary report, 

I and an individual account report are presented in Figures 4-2, 

I 4-3 and 4-4, respectively. 
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PERKIN-ELMER OS/32 ACCOUNTING REPORT 
SYSTEM SUMMARY REPORT 
REPORT PERIOD: OCT/ 4/83 TO OCT/ 5/83 

REPORT DATE: NOV/ 14/8 3 



NUMBER OF TASKS LOADED 

OS CPU TIME 

USER CPU TIME 

USER APU TIME 

WAIT TIME 

ROLL TIME 

ROLL CPU TIME 

ROLL COUNT 

IMPURE MEMORY 

PURE MEMORY 

SYSTEM SPACE USED 

NO. I /OS CLASS 

BYTES TRANSFERRED 

NO. I /OS CLASS 1 

BYTES TRANSFERRED 

NO. I /OS CLASS 2 

BYTES TRANSFERRED 

SECTOR DAYS PER VOLUME 

MTM 



1. 

0: 0: 2.346 

0: 0: 0.768 

0: 0: 3.277 

0: 3:11.056 

0: 0: 0.000 

0: 0: 0.000 

0. 

6-00 KB 

0.00 KB 

1.25 KB 

2056. 
263168. 

1054. 
269824. 

40. 
3219.00 



Figure 4-2 System Summary Report 
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The sample system summary report displayed in Figure 4-2 
summarizes how the computer time was used by one user task 
(u-task) from October 4, 1983 to October 5, 1983. The report 



There is one task. 

The operating system occupied the CPU for 2.346 seconds. 

The u-task occupied the CPU for 0.768 minutes and occupied the 
APUs for 3.277 minutes. 

The system occupied 6.00kb of impure and . OOkb of pure memory 
and 1.25kb of system space. 

There were 2,056 index I/Os, transferring 263,168 bytes. 

There were 1,054 contiguous I/Os, transferring 269,824 bytes. 

There were 40 device I/Os, transferring 3,219 bytes. 

The eimount of sector days for volume=MTM was 3,036. 
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PERKIN-ELMER 08/32 ACCOUNTING REPORT 

ACCOUNT SUMMARY REPORT 
REPORT PERIOD: OCT/ 4/83 TO OCT 5/83 

REPORT DATE: NOV/14/83 



ACCOUNT NUMBER : 0-65535 

PROCESSOR USAGE: 

OS TIME: 0: 0: 2.346 

e 1.5000/SEC. 3.52 

USER CPU TIME: 0: 0: 0.768 

e 0.7500/SEC. 0.58 

USER APU TIME: 0: 0: 3.2,77 

§ 0.6000/SEC. 1.97 

PROCESSOR SUElTOTAL 

MEMORY USAGE: 

SYSTEM SPACE: 1.25 KB 

§ 1.5000/0. 25KB 7.50 

IMPURE MEMORY: 6.00 KB 

§ 0.9000/0. 25KB 21.60 

PURE MEMORY: 0.00 KB 

@ 1.1500/0. 25KB 0.00 



6.06 



MEMORY SUBTOT*!. 



29.10 



I/O USAGE: 



CLASS 0: 

BYTES TRANSFERRED: 

NO. OF I/Os: 
e l.OOOO/IO 

CLASS 1: 

BYTES TRANSFERRED: 

NO. OF I/Oa: 
e I.IOOO/IO 

CLASS 2: 

BYTES TRANSFERRED: 

NO. OF 1/08: 
e 1.1500/IO 



0. 2631680^06 

2056. 

2056.00 



0.269824D+06 

1054. 

1159.40 



0.321900D+04 

40. 

46.00 



I/O SUBTOTA]:. 



3261.40 



DISC USAGE: 



MTM : SECTOR DAYS 3036.0000 

e 1.0500/SECTOR DAY 3187.80 



DISC USAGE SUBTOTAL 


3187.80 1 


TOTAL CHARGES FOR THIS PERIOD 


6484.36 i 


J. DOE 


1 



Figure 4-3 Account Sunvnary Report 
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The sample account sununary report displayed in Figure 4-3 
sunmiarizes the amount of time an individual user, J. Doe, used 
the computer. It also shows the cost of user I/Os and prints out 
the total charges for the period from October 4, 1983 to October 
5, 1983. This report shows that: 

• The OS occupied the CPU for 2.346 seconds, the u-task occupied 
the CPU for 0.768 minutes and the APUs for 3.277 minutes. 

• Memory was divided into 1.25kb of system space and 6.00kb of 
impure memory. 

• There were 2,056 class I/Os, transferring 0.263168D+05 bytes 
charged at $1.0000 per I/O for a total of $2,056.00. 

• There were 1,054 class 1 I/Os, transferring 0.269824D+06 bytes 
charged at $1.1000 per I/O transaction for a total of 
$1,159-40. 

• There were 40 class 2 I/Os, transferring 0.321900D+04 bytes 
charged at $1.1500 per I/O transmission for a total of $46.00. 

• The charges for the disk usage were 3,036.0 sector days at 
$1.0500 per sector day for a total of $3,187.80. 

• The total charges against J. Doe for the period are 
$6,484.36. 



4-26 48-031 FOO R02 



PERKIN-EtHER OS/3:2 ACCOUNTING REPORT 
ACCOUNT NUMBER : 255 
REPORT PERIOD: OCT/ 4/83 TO OCT/ 5/83 

REPORT DATE: NOV/ 14/83 



ACCOUNT NUMBER : 255 

PROCESSOR USAGE: 

OS TIME: 0: 0: 2.346 

§ L.5000/SEC. 3.52 

USER CPU TIME: 0: 0: 0.768 

e 0.7500/SEC. 0.58 

USER APU TIME: 0: 0: 3.277 

e 0.6000/SEC. 1.97 

PROCESSOR SUBTOTAL 

MEMORY USAGE: 

SYSTEM SPACE: 1.2 5 KB 

e 1.5000/0. 25KB 7.50 

IMPURE MEMORY: 6.00 KB 

§ 0.9000/0. 25KB 21.60 

PURE! MEMORY: 0.00 KB 

e 1.1500/0. 25KB 0.00 



MEMORY SUBTOTAL 



I/O USAGE: 



CLASS 0: 

BYTES TRANSFERRED: 

NO. OF I/Oa: 
§ l.OOOO/IO 
CLASS 1: 

BYTES TRANSFERRED: 

NO. OF 1/08 : 
e l.OOOO/IO 

CLASS 2: 

BYTES TRANSFERRED: 

NO. OF I/Os: 
e 1.1500/IO 



0.263168D+06 

2056. 

2056.00 

0.269824D+06 

1054. 

1159.40 



0.321900D+04 

40. 

46.00 



6.06 



29.10 



I/O SUBTOTAL 



3261.40 



DISC USAGE: 



MTM : SECTOR DAYS 3036.0000 

e 1.0500/SECTOR DAY 3187.80 



DISC USAGE SUBTOTAL 



3187.80 



TOTAL CHARGES FOR THIS PERIOD 



6484.36 



J. DOE 



Figure 4-4 Individual Account Summary Report 
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The sample individual account summary summarizes how account 
number 255 utilized the OS, CPU and APUs from October 4, 1983 to 
October 5, 1983. The report shows that: 

• The OS occupied the CPU for 2.346 seconds. 

• The u-task occupied the CPU for 0.768 minutes and occupied the 
u-task occupied the CPU for 0.768 minutes and the APUs for 
3.277 minutes. 

• System space occupied 1.25kb of memory and impure memory 
occupied 6.00kb. 

• There were 2,056 class I/Os, transferring . 263168D+06 . 

• There were 1,054 class 1 I/Os, transferring 0.269824D+06 
bytes . 

• There were 40 class 2 I/Os, transferring 0.321900D+04 bytes. 

• The amount of sector days used for volume=MTM was 3,036. 
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SAVE 



4.3.6 SAVE Cointimeind 

The SAVE command generates archival files from the accounting 
data specified by the GET and SELECT commands and sends the 
archival files to the fd specified in the SAVE command. 



Format : 



SAVE fdQ,NEW] 



Parameters ; 



fd 



NEW 



is the file descriptor to which the generated 
archival file is sent. The specified fd can 
be a magnetic tape or an indexed file. 

If the specified fd is a magnetic tape device 
and this pariameter is entered, the accounting 
data is copied to the beginning of the 
magnetic tape. If the specified fd is a disk 
file and this parameter is entered, an indexed 
file with a record length of 1,024 and a block 
size of 1 (1,024/1) is allocated. The 
accounting data is then copied to the 
beginning of the disk file. If this parameter 
is omitted for magnetic tape or disk devices, 
the accounting data is appended to the 
previously created archives on the specified 
fd. 



Functional Details: 

If the specified fd is an existing disk file and the NEW 
parameter is entered, the accounting data is not copied to the 
specified fd and a message indicating the file cannot be 
allocated is displayed to the list device. 

When the NEW parameter is omitted for disk files, the disk file 
is positioned so that accounting data can be appended to the 
file. When the NEW paraimeter is omitted for magnetic tape files, 
a double filemark is searched and a backspace filemark operation 
is performed to position the tape so that accounting data can be 
appended to the tape . 

All accounting data is copied to tape or disk in compressed 
format, with the first record containing header information. 
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The first record on each magnetic tape volume is an 80-byte 
volume identifier. The OS/32 Copy conventions for multivolume 
magnetic tape files apply to archival files stored on magnetic 
tape. 
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I PAUSE I 



4.3.7 PAUSE Command 

The PAUSE command pauses execution of the Accounting Reporting 
Utility and returns control to the operating system. 

Format : 

PAUSE 



Functional Details: 

The CONTINUE command can be used to continue the Accounting 
Reporting Utility to resume processing. 
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END 



4.3.8 END Command 

The END command terminates execution of the Accounting Reporting 
Utility. 

Format : 



END 



Functional Details: 

When the Accounting Reporting Utility terminates, an end of task 
code is displayed. 
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4.4 ACCOUNTING REPORTING UTILITY TASK TERMINATION CODES 

There are three possible task termination codes that can be 
issued at the termination of the Accounting Reporting Utility 
task. 



• A task termination code of indicates normal termination. 

• A task termination code of 1 indicates an invalid start option 
was used (see Section 4.2.2). 

• A task termination code of 2 indicates an error occurred while 
the task was executing in batch mode. 

4.5 ACCOUNTING REPORTING UTILITf MESSAGE SUMMARY 

ACCOUNT INACTIVE-.n 

The account number had no recorded transactions. 

ACCOUNT NOT SELECTED :n 

An account number was specified in the REPORT command and 
was not specified in the SELECT command. 

COMMAND DEVICE ERROR 

The syntax of the command device or file entered as a 
start option is invalid. 

COMMAND NOT RECOGNIZED 

An invalid command was entered. 

DATE NOT SELECTED 

The dates specified in the REPORT command are not within 
the time period specified in the SELECT command. 

DUPLICATE NAME: fd 

An ATF , archival filename or disk volume was entered 
twice . 

DUPLICATE START OPTION 

One of the start options was entered more than once. 
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FILE DESCRIPTOR ERROR: fd 

The file descriptor was invalid or omitted. 

FILE ERROR ON: fd 'ASSIGNMENT ERROR' 

lu is already assigned or device is off-line. 

FILE ERROR ON: fd 'BUFFER ERROR' 

Insufficient system space for file control block (FCB) 
and/or buffers. 

FILE ERROR ON: fd 'FILE DESCRIPTOR ERROR' 

The format of the file descriptor is incorrect. 

FILE ERROR ON: fd 'I/O ERROR' 

An SVCl I/O error has occurred while accessing the disk. 
See the OS/32 Application Level Programmer Reference 
Manual . 

FIL£ ERROR ON: fd 'NAME ERROR' 

If trying to allocate or rename, the filename already 
exists on the specified volume. If attempting to assign 
or delete, the named file does not exist on the specified 
volume. 

FILE ERROR ON: fd 'PRIVILEGE ERROR' 

File is already assigned for exclusive access; file may 
be assigned to another task. 

FILE ERROR ON: fd 'PROTECT ERROR" 

Read/write protection keys do not match; invalid 
protection keys. 

FILE ERROR ON: fd 'SIZE ERROR' 

Insufficient space exists on specified volume to allocate 
a file of the specified size. 
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FILE ERROR ON: fd 'TYPE ERROR' 

Nondirect access device or device is marked off-line. 

FILE ERROR ON: fd 'VOLUME ERROR' 

The volume specified or defaulted in fd does not exist in 
the system; volume specified is not mounted. 

INVALID ACCOUNT NUMBER :n 

The account number entered was not in the allowable 
range. 

INVALID ARGUMENT 

An argument was invalid or was entered twice. 

INVALID DATE: date 

The data entered was in an incorrect format or was 
omitted. If the 'to' date was an earlier date than the 
'from' date, the default dates are reset. 



INVALID DATES ON: fd,fd 

The dates recorded in the two input files specified by 
fd,fd contain records with overlapping dates. 



INVALID DECIMAL PARAMETER:n 

The decimal number entered was incorrect or was omitted. 

INVALID FILE OR DEVICE: fd 

A file specified in the GET or SAVE commands has an 
invalid file type or record length or the specified fd is 
an invalid device. 

INVALID RANGE: range 

The first account number specified in the range was 
higher than the second account number (end of range) . 
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INVALID SEPARATOR 

One of these required separators was missing or 
incorrect: 



Parentheses ( ) 
Comma , 
Equal sign - 
Quotes • ' 
Slash / 



INVALID START OPTION 

The command, list or log device or file entered as a 
start option is invalid. 



INVALID VOLUME NAMErvolid 

The volid specified in the DISK parameter of the GET 
command is an invalid volume name. 



INVALID REPORT DATES 

The report dates are out of chronological order. 

INVALID SELECT DATES 

The select dates are out of chronological order. 

I/O ERROR ON fd 'DEVICE UNAVAILABLE' 

The specified fd was unavailable, causing the program to 
pause. To retry the I/O, enter the CONTINUE command. 

I/O ERROR ON fd 'END OF FILE' 

An end of file condition occurred while processing the 
specified fd, causing the program to pause. To retry the 
I/O, enter the CONTINUE command. 

I/O ERROR ON fd 'END OF MEDIUM' 

An end of medium condition occurred while processing the 
specified fd, causing the program to pause. To retry the 
I/O, enter the CONTINUE command. 
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I/O ERROR ON fd ' I LLEGTU^/UNASS I GNED LU ' 

An illegal lu was specified, or a required lu was not 
assignedf causing the progrsun to pause. To retry the 
I/O, enter the CONTINUE command. 



I/O ERROR ON fd 'PARITY/RECOVER. ERROR' 

A parity or recoverable error occurred on the specified 
fd, causing the program to pause. To retry the I/O, 
enter the CONTINUE command. 



I/O ERROR ON fd ' UNRECOVERAfJLE ERROR' 

An unrecoverable error occurred on the specified fd, 
causing the program to pause. To retry the I/O, enter 
the CONTINUE command. 



LIST DEVICE ERROR 

The device or file specified as the list device is 
invalid . 



LIST DEVICE UNASSIGNED 

The list device assigned when the program started was 
closed by the user. 



LOG DEVICE ERROR 

The device or file specified as the log device is 
invalid. 



MOUNT NEXT TAPE ON fd 

An end of volume condition exists on the magnetic tape 
specified by the fd, causing the Reporting Utility to 
pause. Mount a new tape and continue the utility with 
the CONTINUE command. 



NO INPUT SPECIFIED 

A REPORT or SAVE command was issued before a GET command 
was specified. 



48-031 FOO R02 4-37 



NO MORE AVAILABLE MEMORY: fd 

The list of ATFs, archives or volume names entered in the 
GET command exceeds the maximum number the program can 
accept . 



SYNTAX ERROR 

The syntax of the start options is invalid. 

TEXT TOO LONG 

The contents specified in a DATE, MESSAGE, SIGNATURE, 
HEADER, TACCOUNT, TSUMMARY or TSYSUSE parameter in the 
OPTION command exceed the maximum allowable length. 

VOLUME NOT ON-LINE : vol id 

A disk volume specified in the GET command is not on-line 
to the system, causing the Reporting Utility to pause. 
Mark the specified disk on-line and continue the utility 
with the CONTINUE command. 

VOLUME OUT OF SEQUENCE ON: fd 

The tape volume containing parts of an archive was 
mounted in the wrong order . 
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CHAPTER 5 
ERROR REPORTING UTILITY 



5.1 GENERAL DESCRIPTION 

The Error Reporting Utility (ERROR. TSK) produces reports from the 
error log information recorded by the hardware error logger and 
stored on the error recording file by the operating system. 
These reports contain diagnostic information for memory errors, 
I/O errors, system errors and system milestones. The Error 
Reporting Utility commands allow the operator to: 

• Specify an error recording file produced by the system error 
recording routines or a previously created archival file. 

• Select a subset of the errors to be included in the report by 
specifying the starting and ending dates of the time period in 
which those errors occurred. 

• Build a memory configuration definition (MCD) file that can be 
used to interpret memory errors. 

• Output a summary and, optionally, an itemized list of errors. 

• Output a memory error report that reports logical addresses as 
well as physical locations of memory errors. 

• Save error log information on an archival file. 

5.2 DESCRIBING MEMORY TO INTERPRET ERRORS 

To describe memory to interpret errors, users must know how their 
installation's hardware is configured. See your customer service 
representative for this information. 

If error recording is included in the system, the current memory 
hardware configuration must be described to the operating system 
through the MCONFIG macro at system generation (sysgen) time. 
See the System Generation/32 (Sysgen/32) Reference Manual. 

Memory is physically broken into the following: 

• Blocks 

• Banks 

• Modules 
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Memory is also logically broken into storage units. 

A block is an area in memory to which a specific number of 
megabytes is assigned by the user. The smallest block allowed is 
1Mb, and the largest block allowed is 16Mb, with the total size 
of all blocks combined not exceeding 16Mb. Each block must be 
aligned on a megabyte boundary and must be described starting 
with block and not exceeding block 15. If shared memory is 
included in the system, it must be described following local 
memory- Shared and local memory cannot share the saune block. 
(See Figure 5-1.) For more information on shared memory, see the 
Perkin-Elmer Model 3220, 3240 and 3250 Processors Shared Memory 
Systems Installation and Maintenance Manuals. 



Block 4 
Block 3 
Block 2 
Block 1 
Block 



4Mb 



4Mb 
2Mb 



2Mb 
4Mb 



Shared 
memory 



^ 



> 16Mb 



Local 
memory y 



Figure 5-1 Memory Described as Blocks 



If interleaving of memory within a block is desired, that block 
can be broken into smaller areas called banks. A block can be: 



• non inter leaved (1 bank), 

• 2 -way interleaved (2 banks), or 

• 4-way interleaved (4 banks). 

Banks within a block are equal in size and each has its own 
memory controller. The blocks shown in Figure 5-1 are further 
defined in Figure 5-2 to show blocks broken into banks. 



5-2 
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Bank Bank 1 Bank 2 Bank 3 



Block 4 1 


1Mb 


1Mb 1 


IMfc) 


1Mb 


Block 3 ! 


1Mb 


1Mb 


IMk) 


1Mb 


Block 2 1 


1Mb 


1Mb 1 


Block 1 1 


1Mb 


1Mb 1 


Block 1 


4Mb 





4-way 
interleaved 
4-way 

interleaved 
2 -way 

interleaved 
2 -way 

interleaved 
Non inter leaved 



N 



>16Mb 



Figure 5-2 Memory Described as Blocks eind Banks 



Banks are physically broken into smaller areas called modules, 
which are also controlled by the memory controller belonging to 
that bank. There are two general types of modules: 



• Single density storage module (SDSTM) 

• Double density storage module (DDSTM) 



These two types of modules cannot be intermixed on the same 
machine. Table 5-1 identifies the STMs. 



TABLE 5-1 STM INFORMATION 



FUNCTIONAL VARIATION i STM DEFINITIONS 

FOO* (256kb) I SDSTM (fully populated with 16K chips) 

FOl** (256kb) I DDSTM (half populated with 16K chips) 

I 
F02** (512kl3) I DDSTM (fully populated with 16K chips) 



F03** (l,024kb or 1Mb) | DDSTM (half populated with 64K chips) 
F04** (2,048kb or 2Mb) | DDSTM (fully populated with 64K chips) 



* Used on Perkin-Elmer Model 3220 and 3240 processors. 
** Used on Perkin-Elmer Model 3210, 3230, 3250XP and 3200MPS 
processors. 
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The size of a bank must equal 
within that bank. 



the total size of all modules 



Block 0, bank in Figure 5-2 is extracted and magnified in 
Figure 5-3 to show banks broken into modules. The high density 
modules occupy low-address space. 



Memory Controller 
Bank 
( non inter leaved ) 



r 



Block 0<;^ 



^ 



V 



F02 


1 

1 


F02 


i 


F02 


1 


F02 


1 
1 


F04 



512kb 



512kb 



512kb 



512kb 



2Mb 



> 4Mb 



J 



Figure 5-3 A Bank Broken into Modules 



Banks are also logically broken into smaller areas called storage 
units, which are determined by the size of the bank. 

If the bank size within a block is less than or equal to 4Mb, 
those banks are broken into 256kb storage units. The number of 
storage units can range from 1 to 16, depending on the size of 
the bank. If the bank size within a block is greater than 4Mb, 
those banks are broken into 1Mb storage units. The number of 
storage units can range from 5 to 16, depending on the size of 
the bank. See Figure 5-4. 



5-4 
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/^ 



r 



Block 0<f 



I 



T 



Memory Controller 
Bank 
( non Inter leaved ) 



F02 



F02 



F02 



F02 



F04 



-A- 



Storage unit F 
Storage unit E 



Storage unit D 
Storage unit C 



Storage unit B 
Storage unit A 



Storage unit 9 
Storage unit 8 



Storage unit 7 
Storage unit 6 



Storage unit 1 
Storage unit 



■^ 



N 



N 



256kb 



256kb 



512kb 



256kb 



256kb 



512kb 



256kb 



256kb 



512kb 



I 



I 
I 
I 



y 



> 4Mb 



256kb 



256kb 



512kb 



256kb 
256kb 



> 



>2Mb 



256kb 
256kb 



J 



J 



Figure 5-4 A Bauik Broken into Storage Units 



48-031 FOO RCI2 



5-5 



5.3 LOADING AND STARTING THE ERROR REPORTING UTILITY 

To load and start the Error Reporting Utility, enter the 
following conuncmds. 

Formats : 



LOAD ERROR 

START [,[ COMMAND- fdi] (^LOG^fda]"] 

Parameters: 



COMMAND^ fdi specifies the file descriptor of the 

command input device. If this parameter is 
omitted, the console device (CON:) is the 
default. If fd is not an interactive device, 
a log device must also be specified. 

LOG= fd2 specifies the file descriptor of the log 

device. If the command input device is not 
interactive, this parameter must be specified. 



Messages : 



COMMAND DEVICE ERROR 

indicates that the specified command device could not be 
assigned. 



INVALID STARTING PARAMETER 

indicates that a starting parameter other than COMMAND= 
or LOG= was specified. 



LOG DEVICE ERROR 

indicates that the specified log device could not be 
assigned. 

5.4 SPECIFYING THE INPUT FILE 

The GET command identifies the file that contains the error 
records from which an error report is generated. This file is 
created when the system operator enables the Error Recording 
Facility on the system. See the OS/32 Operator Reference Manual. 
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Format : 



GET fd 



Parameter : 



fd 



is the file descriptor of the file used by the 
system error recording routines to store error 
records. The specified fd is assigned 
exclusive read-only (ERO) privileges. 



Functional Details: 



The GET command must be spe 
reporting commands are specif 
currently be in use for system 
procedure is to turn the Err 
specified file; then turn the Er 
new fd specification. The pre 
by the Error Reporting Utility, 
file in the GET command. If the 
magnetic tape volume, the follov«? 
additional tape needed: 



cified before any other error 

ied. The specified file must not 

error recording. The optimum 

or Recording Facility off for the 

ror Recording Facility on with a 

vious fd is now available for use 

It is possible to specify a tape 

tape file spans more than one 

ing message is displayed for each 



MOUNT NEXT TAPE 



The task pauses, allowing the operator to mount the next tape. 
After mounting the tape, the operator continues execution by 
entering the CONTINUE command. The request to mount a new tape 
occurs after the Error Reporting Utility has begun processing the 
error file entries as requested via a REPORT command. 

5.5 DEFINING MEMORY CONFIGURATION 

The DEFINE command allows a user to define system memory 
configuration. This enables the Error Reporting Utility to 
identify the location of memory errors. With this command, the 
user can: 



Initially create a memory configuration definition (MCD) file 
for the system via a sequence of prompts issued by the Error 
Reporting Utility. 

Display the memory configuration of the system, as defined by 
a previously created MCD file, to a log or list device . 



Specify an MCD file that the Error Reporting Utility 
to interpret and locate memory errors. 



is to use 
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Format: 



DEFINE fd 



_ (interpret! 



Parameters: 
fd 



CONFIG 



INTERPRET 



is the file descriptor of the MCD to be 
created or of a previously created MCD. If 
the CONFIG or INTERPRET parameters are 
omitted, the Error Reporting Utility issues a 
series of prompts to allow the user to create 
a new MCD file. 

specifies that the content of the MCD file 
specified is to be displayed to the 
appropriate device. No prompt sequence is 
issued. 

specifies that the data in the specified file 
is used to interpret subsequent memory errors. 
No prompt sequence is issued and the specified 
MCD file must exist on disk. 



Functional Details: 

When the DEFINE command is issued without the CONFIG or INTERPRET 
parcutieters, a prompt sequence is issued. Explanations of each 
prompt and valid responses are provided. When the user enters an 
invalid response, the error is identified and the prompt sequence 
returns to the prompt preceding the error. The prompt sequence 
must be restarted if the user enters incorrect information, such 
as the wrong STM type, since the automatic recovery procedure 
will not consider this an invalid entry. The prompt sequence 
consists of the following prompts: 



Prompt: HOW MANY BLOCKS? 

Response: n 

n is a decimal number from 1 to 16, 
from 1Mb to 16Mb and must be 
boundary. When the response is 



labels the blocks, beginning with block 0. 



A block consists of 
aligned on a megabyte 
entered, the prograim 



5-8 
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NOTES 

Unless otherwise specified via an MCD 
file, the Error Reporting Utility 
will assume that the memory is 
configured using FOl STMs as the 
default and will identify the 
location of memory errors according 
to the layout of that STM. If a 
system contains STMs of a type other 
than FOl, the resulting error 
locations may be misleading. It is, 
therefore, advisable to specify an 
MCD before reporting memory errors if 
there is any doubt about the type of 
STMs in use. 

When defining memory configuration, 
total memory must end on a full 
megabyte boundary. Therefore, when 
actual total memory does not end on 
a full megabyte boundary (e.g., 2 
l/4Mb or 8 l/2Mi3) , it is necessary to 
raise the total memory size to the 
next full megabyte value above the 
actual memory size before dividing 
into blocks. For example: 



~ 2 l/4Mb becomes 3Mb. 
- 8 l/2Mb becomes 9Mb. 



This is necessary for the following 
two reasons: 



The memory configuration procedure 
does not allow the entry of block 
sizes of less than a whole 
megabyte . 

For the purpose of error 
reporting, all memory must be 
represented eis contiguous. If a 
system has local and shared 
memory, and local memory does not 
end on a full megabyte boundary, 
there will be a gap between the 
end of local memory and the start 
of shared memory. Shared memory 
always begins on a full megabyte 
boundary . 
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Therefore, to Insure that no gap 
is present between local and 
shared memory, local memory should 
be raised to the next full 
megabyte value and the appropriate 
module types added to account for 
the size of the gap. 



Error Message: MEMORY EXCEEDS 16Mb 

Recovery: The program reissues the prompt, 

• Prompt: HOW MANY BANKS IN BLOCK n? 

Response: 




Banks are contained within blocks and are of equal length. 
A block has more than one bank only if it is interleaved. 
The valid responses have the following meanings: 

1 = Non inter leaved 
- 2 = 2 -way interleaved 
4 =. 4-way interleaved 

Error Message: NUMBER OF BANKS INVALID 
Recovery: The progrcun reissues the prompt. 

• Prompt: HOW MANY MODULES IN BANK n? 
Response: n 

n is a decimal number from 1 to 64. 

Error Message: INVALID NUMBER OF MODULES 
Recovery: The program reissues the prompt. 

• Prompt: ENTER MODULE TYPES 

Response: module type , module type , . . . ,module type 

Table 5-2 shows the variable module types and the memory and 
chip size of each. 
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TABLE 5-2 MODULE TYPES AND SIZES 



1 MODUT.R 1 


SIZE OF 


CAPACITY 




1 TYPE 1 


MEMORY 


OF CHIPS 


DENSITY 


1 ^=-«- 


Si^aEfB^atBS'S^^aitaiSSKBBiaBXB^^X^DBtKiXSSiiaB^B? 


2f2^9l:K^^SBTBSK 


1 FOO j 

j j 


256kb 


16kb 


Single 


1 FOl 1 
j 1 


256kb 


16kb 


Double 


1 F02 1 


512kb 


16 kb 


Double 


j F03 ! 
1 1 


1024kb or 1Mb 


64kb 


Double 


1 F04 1 


2048kb or 21Mb 


64kb 


Double 



WARNING 

DO NOT ATTEMPT TO MIX SDSTMS AND DDSTMS . 
THE ERROR REPORTING UTILITY WILL NOT 
ACCEPT THEM AND WLLL ISSUE THE FOLLOWING 
ERROR MESSAGE: 



PRECEDING MODULE INCOMPATIBLE 



The module types must be entered in ascending order. The 
total size of all modules entered must not exceed 16Mb. 



Error Message: INVALID MODULE TYPE 

Recovery: The program reissues the prompt, 



Error Message: 
Recovery: 



TOO MANY MODULES 

The program reissues the prompt; the previous 
entries are retained. 



Error Message: PRECEDING MODULE INCOMPATIBLE 



Recovery: 



The program restarts the prompts at the module 
definition sequence. 



Error Message: CONFLICTING BANK LENGTH IN BLOCK 



Recovery: 



The program reissues the prompt starting at 
the definition of the block. 
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Error Message: BLOCK NOT ON MB BOUNDARY 

Recovery: The program reissues the prompt starting at 

the definition of the block. 



When specifying the MCD file, new commands cannot be entered 
until all prompts are answered. To return control to the command 
level, enter the following word: 



£EDEF INE 



Examples: 

The following is a sample prompt session. It designates 
MEMDEF.FIL as the fd Of the memory configuration file to be 
built. The defined memory has two blocks, and both blocks have 
two banks. Pin error occurs when BLOCK 1, BANK is being 
defined. The user enters too many modules- The prompt sequence 
recovers by reissuing the request to define BLOCK 1, BANK 0. 

DEE MEMDEF.FIL 

HOW MANY BLOCKS? 

2 

HOW MANY BANKS IN BLOCK 0? 

2 

HOW MANY MODULES IN BANK 0? 

2 

ENTER MODULE TYPES 

F02, F02 

HOW MANY MODULES IN BANK 1? 

2 

ENTER MODULE TYPES 

F02 

ENTER MODULE TYPES 

F02 

HOW MANY BANKS IN BLOCK 1? 

2 

HOW MANY MODULES IN BANK 0? 

4 

ENTER MODULE TYPES 

F01,F01,F01,F01,P01 

TOO MANY MODULES 

ENTER MODULE TYPES 

F01,F01,F01,F01 

HOW MANY MODULES IN BANK 1? 

4 

ENTER MODULE TYPES 

F01,F01,F01,P01 
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The following example displays the configuration data from the 
file MEMDEF.FIL. 



DEF MEMDEF.FIL, CONFIG 

MEMORY CONFIGURATION DEFINITION ON MEMDEF.FIL 



BLOCK 

BANK 
F02 
F02 

BANK 1 
F02 
F02 
BLOCK 1 

BANK 
FOl 
FOl 
FOl 
FOl 

BANK 1 
FOl 
FOl 
FOl 
FOl 



2 WAY INTERLEAV15D 



2 WAY I NTE RLE AVISO 



The following conanand notifies the Error Reporting Utility that 
file MEMDEF.FIL is to be used to interpret memory errors during 
report generation. 



DEFINE MEMDEF.FIL, INTERPRET 



5.6 SELECTING SPECIFIC DATA 

The SELECT command selects by time of occurrence the errors to 
report or save to an archival file. 



Format: 



SEL£CT 



ZEOM = 



imon/dd/yy ) r- 
dd/mon/yy 



> Lhh hmm Qss] J 



,IQ= 



!mon/dd/yy ) 
dd/mon/yy 



/> , hh f: mm Q ssj 1 
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Parameters: 



mon 
dd 

yy 

hh 



is the name of the month and can be 
abbreviated to three alphabetic characters. 

is the decimal number from 1 to 31 specifying 
the day of the month. 

is a decimal number from 00 to 99 specifying 
the year . 

is a decimal number from 00 to 23 specifying 
the hours. 



mm 



is a decimal number from 00 to 59 specifying 
the minutes . 



ss 



is a decimal number from 00 to 59 specifying 
the seconds . 



Functional Details: 

The first date format is valid only if the United States format 
option was selected at sysgen. The second date format is valid 
only if the European format option was selected at sysgen. 

The date and time in the FROM parameter specify the beginning of 
the desired interval; the date and time in the TO parameter 
specify the end of the desired interval. The errors that 
occurred within the specified interval are then used to generate 
reports and can be saved to an archival file. 

If the FROM parameter is omitted, the interval begins with the 
date and time of the earliest entry in the error file. If the 
date is given but the time is omitted, the time defaults to 
00:00:00. If the TO parsuneter is omitted, the interval ends with 
the date and time of the latest entry in the error file. If the 
date is given but the time is omitted, the time defaults to 
23:59:59. If the time is partially specified in both the FROM 
and TO parameters, the defaults for minutes and seconds are 0. 
If SEILECT is not entered, all errors in the error file are 
available for use by the REPORT or SAVE command. 
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5.7 GENERATING AN ERROR REPORT 

The REPORT command outputs error reports. 

Format: 

EEPORT f d QlIST^ 

Parameters: 

f<3 specifies the device to which all selected 

error information in the error recording file 
is output. Error information is automatically 
output in the summary format. See Section 
5.7.2 for a description of the summary format. 

^^^■^ specifies that all selected errors are output 

in a list format, in addition to being 
included in the summary report. See Section 
5.7.1 for a description of the list format. 

5.7.1 List Reports 

The categories of the list reports are: 

• Bulk device input/output (I/O) error report 

• File manager detected error reports 

• System detected error reports 

• System milestone reports 

• Memory errors 

All of these reports are produced when a REPORT command is 
issued, provided at least one error of each type is present in 
the error file being reported. If no errors of a particular type 
occurred during the reporting period, then that category of 
report is not generated. ^ 

The following sections show formats for list and summary reports. 
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5.7.1.1 Bulk Device Input/Output (I/O) Error Report 



Format: 



031-1 



mon/dd/yy 

DEVICE 

CONTROLXER 

SELCH 



hh:mm:3S BULK DEVICE I/O ERROR 



STATUS - ssas NAME 
STATUS - nnnn 
STATUS - niinmm 



-xxxx 



ADDRESS - bbbbbbbb 

ADDRESS = cccccccc 

ADDRESS - dddddddd 

SECTOR - rrrrrrrr HEAD - kkkkklckk CYLINDER - YYYYYYYV 
DRIVER ENTRY COUNTER - VVVVVVVV SVC FC-gg; USER STATUS-pppp 
BUFF START = aaaa BUFF END - bbbb SELCH END = cccc 
CURRENT ESR => qqqqqqqq CURRENT INTERRUPT HANDLER - hhhhhhhh 
MMDLOG LINK - ZZZZZZZZ INFO/SECONDARY LINK - liilliil 



Fields: 



DEVICE information includes: 



ADDRESS = 



bbbbbbbb is the hexadecimal address of the 
device. 



STATUS = 



ssss is a hexadecimal number indicating the 
status of the device. 



NAME = 



XXXX is the device name. 



CONTROLLER information includes: 



ADDRESS 



STATUS = 



CCCCCCCC is the hexadecimal address of the 
controller . 

nnnn is a hexadecimal number indicating the 
status of the controller. 



SELCH information includes 



ADDRESS •= 



STATUS 



SECTOR 



dddddddd is the hexadecimal address of the 
selector channel (SELCH) . 



mmmm is a hexadecimal 
status of the SELCH. 



number indicating the 



rrrrrrrr is the hexadecimal address of the 
sector where the error occurred. 
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HEAD = 



CYLINDER 



DRIVER ENTRY 
COUNTER = 

SVC PC = 



kkkkkkkk is the hexadecimal address of the 
track where the error occurred. 

yyyyyyyy is the hexadecimal address of the 
cylinder where the error occurred. 

vvvvvvvv is 21 hexadecimal number indicating 
the sequence number of the I/O request. 

gg is the supervisor call function code that 
was used to send the specific type of I/O. 



USER STATUS =' pppp is the SVC status returned to the user . 

BUFF START = aaaa is the hexadecimal address of the start 

of transfer. 



BUFF END 



bbbb is the hexadecimal address of the planned 
end of transfer. 



SELCH END - 



CURRENT ESR 



CURRENT 
INTERRUPT 
HANDLER - 



cccc is the hexadecimal address of the actual 
end address of transfer. 

qqqqqqqq is the address of the event service 
routine executing I/O at the time the error 
occurred. 

hhhhhhhh is the hexadecimal address of the 
interrupt handler. 



MMDLOG LINK = 



zzzzzzzz is a hexadecimal number of the 
location in the OS/3 2 driver that logged the 
entry indicating the precise driver activity 
at the time the error was detected. 



INFO/ 
SECONDARY 
LINK = 



iiiiiiii is a hexadecimal number indicating 
the location in the OS/32 driver of the 
higher level subroutine call further 
clarifying driver activity at the time the 
error was detected. This field can also 
contain additional information provided by the 
primary call MMDLOG LINK. 



5.7.1.2 File Mamager -Detected Errors 

The following are five types of reports generated when the file 
manager detects an error. 
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Report Type 1 - Bit map inconsistency when allocating an 

allocated disk sector 



Format; 



mon/dd/yy hh:mm:as BIT MAP ERROR VOL - voln SECTOR = nnnnnnnn 
TYPE - type ; START SECTOR » XXXXXXXX LENGTH = yyyy 



Report Type 2 



Bit map inconsistency when deallocating an 
already deallocated disk sector 



Format; 



031-3 



mon/dd/yy hhimm-.ss BIT MAP ERROR VOL - voln SECTOR - nnnnnnnn 
TYPE - type ; START SECTOR - XXXXXXXX LENGTH - yyyy 



Fields: 



VOL = 



voln is the name of the volume where the 
error occurred. 



SECTOR =■■ 



nnnnnnnn is a hexadecimal number 
indicating the number of the physical 
sector where the error occurred. 



TYPE - 



START SECTOR = 



type indicates whether the disk sector is 
being allocated or deallocated. 

XXXXXXXX is a hexadecimal number 
indicating the starting sector number of 
the block to be allocated or deallocated. 



LENGTH ■= 



yyyy is a hexadecimal number indicating 
the number of sectors to be allocated or 
deallocated. 



• Report Type 3 - Directory block pointer to next block beyond 

disk range 



Format; 



031-4 



mon/dd/yy hh:mm:as DIRECTORY BLOCK ERROR ON voln 
SECTOR - nnnnnnnn POINTER - yyyyyyyy 
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Fields: 



voln 



is the name of the volume on which the error 
occurred. 



SECTOR = nnnnnnnn is a hexadecimal number indicating 
the number of the physical sector where the 
error occurred. 

POINTEFt = yyyyyyyy is the invalid hexadecimal number 
pointing to the next directory sector. 

Report Type 4 - Indexed block pointer to next or previous 

or index data sector beyond disk range 



Format : 



031-5 



mon/dd/yy hh:mm:S8 INDEX/DATA BLOCK ERROR IN voln: f d/actno 
SElCTOR = nnnnnnnn POINTEIR = yyyyyyyy 



• Report Type 5 - Directory entry for first and/or last logical 

block beyond disk range 

Format : 



031-6 



mon/dd/yy hh:rom:sa DIRECTORY EINTRY ERROR FOR voln:f d/actno 
SECTOR = nnnnnnnn POINTER = yyyyyyyy 



SECTOR 




is the nsune of the volume on which the error 
occurred, 

is the filenajme and account number of the file 
with illegal sector number. 

nnnnnnnn is a hexadecimal number indicating 
the number of the physical sector where the 
error occurred. 



POINTER =- yyyyyyyy is an invalid hexadecimal number 
pointing to the next sector, previous sector, 
index data sector, or first or last logical 
block number . 
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5.7.1.3 System-Detected Errors 

The following report types are generated when the system detects 
an error. 



Report Type 1 - Task queue overflow 



Format : 



031-7 



mon/dd/yy hh:iiun:s3 TASK QUEUE OVERFLOW FOR taskname 

TCB TASK STATUS - nnnnnnnn TSW - xxxxxxxx CODE - T/YYTfYY 



Fields: 



tasknaune 



TCB TASK 
STATUS =■ 



is the nsone of the task for which the system 
was processing when the error occurred. 

nnnnnnnn is the task status in the task 
control block when the overflow occurred. 



TSW = 



xxxxxxxx is the task status word indicating 
the state of the task when the overflow 
occurred. 



CODE - 



yyyyyyyy is the fullword reason code of the 
entry that was to be added to the specified 
task queue. 



Report Type 2 - System queue full; overflow possible 



Format: 

031-8 



mon/dd/yy hh:inin:93 SYSTEM QUEUE FULL - POSSIBLE OVERFIXW 



Report Type 3 - System queue service (SQS) handler processes 

leaf with unspecified SQS routine. 



Format : 



031-9 



mon/dd/yy hh:inm:88 UNSPECIFIED SQS ROUTINE; SERVICE FOR taataiame 
LEAF ADDRESS - XXXXXXXX DCS ADDRESS - YVYYVYYV 
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Report Type 4 - SQS handler processes leaf for device driver 

with unspecified event service routine (ESR) . 



Format; 



031-10 



mon/dd/yy hhtnuntss UNSPECIFIED ESR ROUTINE; SERVICE FOR taskname 
LEAF ADDRESS - xxxxxxxx DCB ADDRESS - YYYYYYYY 



Fields: 



taskn<siine 



is the name of the task for which the 
system was processing at the time the 
error occurred. This may be blank. 



LEAF i\DDRESS 



XXXXXXXX is the address of the leaf that 
was queued with the unspecified routine 
address . 



DCB AI3DRESS 



yyyyyyyy is the address of the device 
control block connected to the leaf . 



Report Type 5 - A level interrupt was ignored. 



Format : 



031-11 



mon/dd/yy hh:mm:88 LEVEL INTERRUPT IGNORED 

psw STATUS - XXXXXXXX psw LOCATION - yyyyyyyy 



Fields: 



PSW STATUS « 



XXXXXXXX is the portion of the prograim 
status word indicating the status when 
the level interrupt occurred. 



PSW UDCATION = 



yyyyyyyy is the portion of the program 
status word indicating the location at 
which the level interrupt occurred. 



The following report type is supported by the R07.1 software 
release and higher. It is only applicable to the operation of 
the Model 32(D0MPS System. 
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• Report Type 6 - APU signal queue 

overflow 



full; possibility of 



Format; 



031-12 



mon/dd/yy hh:mm:S8 APU SIGNAL QUEUE FUIJL - POSSIBLE OVERFLOW 



The following report types are only applicable to the Model 
3200MPS System and are supported by the R07.2 software release 
and higher. 

• Report Type 7 - During task wait removal, it is found that the 

APU is waiting for a control block that is 
inconsistent with the TCB's "APU wait" status. 



Format: 



031-13 



mon/dd/yy hh:nan:88 REMOVE APU WAIT ERROR 

APU»n APU WAIT - wwww TCB STATUS - sassssss TCB WAIT - twtwtwtw 



• Report Type 8 - During task cancellation, it is found that the 

the APU is waiting for a TCB that is 
inconsistent with the TCB's "APU wait" status. 



Format: 

031-14 



mon/dd/yy hh:mm:8S APU RELEASE RESOURCE ERROR 

APU»n APU WAIT - wwww TCB STATUS - ssasassa TCB WAIT - twtwtwtw 



Fields 



APUtt 



n is a hexadecimal number from 1 to 9 that 
identifies the particular APU involved. 



APU WAIT = wwww is a hexadecimal number indicating the 
TCB ID of the task for which the APU is 
waiting. 



TCB STATUS = ssssssss is a hexadecimal number 
the task status of the TCB. 



indicating 



TCB WAIT = 



twtwtwtw is a hexadecimal number 
the task wait state of the TCB. 



indicating 
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• Report Type 9 - An APU signal indicating task passback is 

detected, whereupon the CPU task receive queue 
is found to be empty. 



Format: 



031-15 



mon/dd/yy hh:mtn:8S CPU RECEIVE QUEUE EMPTY ERROR 

liPV SIGNAL - S88S8833 APU LEAF ADDRESS - 11111111 



Fields: 



APU ssssssss is a hexadecimal number representing 
SIGNAJL = the APU signail received. 



APU U3AF 

ADDRESS " event leaf 



Report Type 10 - An APU signal indicating task passback is 

detected, v?hereupon the CPU task receive 
queue is found to be locked. 



Format: 

031-16 



mon/dd/yy hh:m:8s CPU RECEIVli: QUEUE LOCKED ERROR 
COUNT - cccc QUEUE - qqqqqqqq 



Fields; 



COUNT = cccc is a hexadecimal number indicating the 
number of tasks present on the CPU receive 
queue when it locked. 



QUEUE = qqqqqqqq is a hexadecimal 
the receive queue address. 



number indicating 



Report Type 11 



APU execution queue is locked indefinitely, 
perhaps by an APU assigned to the queue. 



Format: 



031-17 



mon/dd/yy hh:m:88 APU EXECUTION QUEUE LOCKED ERROR 
BIT MAP - bbbb QUEUE - qqqqqqqq 
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Fields: 



BIT MAP = bbbb Is a hexadecimal number representing the 
APU-to-queue assignment bit map. 



QUEUE 



qqqqqqqq is a hexadecimal number indicating 
the APU queue address. 



• Report Type 12 - the APU does not respond to status 

interrogation and/or control commands. 



Format: 



031-18 



mon/dd/yy hh:iran:38 APU NO RESPONSE ERROR 
APU#n FLAGS - ffffffff 



Fields: 



APU# 



n is a hexadecimal number from 1 to 9 
identifies the particular APU involved. 



that 



FLAGS = ffffffff is a hexadecimal number indicating 
the value of the APU interval state field 
(APB.FLGS) - 



Report Type 13 - APU data or a signal is received through a 

real-time support module (RTSM) with parity 
error . 



Format: 

031-19 




mon/dd/yy hhrnvmiss RTSM RECEIVE PARITY ERROR 
APUin DATA BYTE - vv FLAGS - ffffffff 



n is a hexadecimal number from 1 to 9 
identifies the particular APU involved. 



that 



DATA BYTE = vv is a hexadecimal number representing 
data or signal byte received. 



the 



FLAGS 



ffffffff is a hexadecimal number indicating 
the value of the APU internal state field 
(APB.FLGS) . 
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5.7.1.4 System Milestones 

The following are six types of reports generated when a system 
milestone occurs: 

• Report Type lA - Marking on a bulk device 

Format: 

031-20 



mon/dd/yy hh:mm:8S DEVICE xxxx MARKED ON ; VOLUME NAME 
BLOCKS I ZE - nnnn EXPANSION - xxxx 
-WRITE PROTECT - DIRECTORY -SYSTEM 



yyyy 



Fields: 



DEVICE 



xxxx is the mnemonic of the device being 
marked on-line. 



VOLUME NAME = 



yyyy is the volume naune of the device 
involved. 



BLOCKS I ZE 



nnnn is the blocks ize specified or 
defaulted to when marking a nonbulk 
device on-line. 



EXPANSION = 



xxxx is the expansion specified or 
defaulted to when marking a bulk device 
on-line. 



Report Type IB - Marking on a nonbulk device 



Format; 



031-21 



mon/dd/yy hh:nim:as DEVICE xxxx MARKED ON; DEVICE NUMBER - YVyyYYYY 



Fields: 



DEVICE 



XXXX is the mnemonic of the device being 
marked on-line. 



DEVICE NUMBER YYYYYYYy is ^ decimal number specifying 

the device being marked on-line. 
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• Report Type 2A - Marking off a bulk device 



Format: 



031-24 



mon/dd/yy hh:mm:as DEVICE xxxx MARKED OFF; VOLUME NAME - yyyy 
TOTAL I/O - nnnnnnnn TOTAL ERRORS - nanmmmnunm 



Fields: 



DEVICE 

VOLLFME NAME = 
TOTAL I/O = 

TOTAL ERRORS = 



xxxx is the mnemonic of the device being 
marked off-line. 

yyyy is the volume name of the device 
involved. 

nnnnnnnn is the total number of times the 
driver was entered before the device was 
marked off-line. 

mmmmmrarom is a decimal number specifying 
the total number of errors that occurred 
on the device before it was marked 
off-line. 



• Report Type 2B - Marking off a nonbulk device 



Format ; 

031-23 



mon/dd/yy hhtmmiss DEVICE xxxx MARKED OFF; DEVICE NUMBER - yyyyyyyy 



Fields: 



DEVICE 



DEVICE 
NUMBER = 



xxxx is the mnemonic of the device being 
marked off-line. 

yyyyyyyy is a decimal number specifying 
the device being marked off-line. 



Report Type 3 - Volume change for system, spool, roll or 

temporary volume 



Format : 



031-22 



mon/dd/yy hh:mm:8a xxxx DESIGNATED AS yyyy VOLUME 
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Fields; 



xxxx 

yyyy 



is the volume name of the device. 

is either temp, roll, spool or system volume. 



• Report Type 4 



No system space for error recording; third 
allocated system buffer full; error recording 
file not allocated; I/O error when writing to 
error recording disk file 



Format : 

031-25 



mon/dd/yy hh:n>ro:s3 ERROR RECORDING RESUMED 




TOTAL ERRORS LOST 


bbbbbbbb 


MEMORY errors: 


dddddddd 


BULK device I/O ERRORS 


mmitimmmmm 


FILE MANAGER DETECTED ERRORS 


nnnnnnnn 


SYSTEM DETECl'ED ERRORS 


xxxxxxxx 


SYSTEM MILESTONES 


yyyyyyyy 


1 " J 



Fields: 



TOTAL EIRRORS 
LOST 



MEMORY ERRORS 



bbbbbbbb is a decimal number specifying 
the total number of errors not recorded 
due to any of the events mentioned in the 
definition of Report Type 4. The totals 
presented below represent total numbers 
including the errors lost. 

dddddddd is the total number of memory 
errors. 



BULK DEVICE 
I/O ERRORS 

FILE M/O^AGER 

DETECTED 

ERRORS 



tnmmmmmmm is the total number of device 
I/O errors. 

nnnnnnnn is the total number of file 
manager detected errors. 



SYSTEM 

DETECTED 

ERRORS 



XXXXXXXX is the total number of system 
detected errors. 



SYSTEM 
MILESTONES 



yyyyyyyy is the total number of system 
milestones . 
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Report Type 5 - System queue reached its depth. 



Format: 



031-26 



mon/dd/yy hh:nun:3S SYSTEM QUEUE REACHED DEPTH n 



Fields; 



SYSTEM QUEUE 
REACHED DEPTH 



n is the depth of the system queue at the 
time of error recording. An initial 
depth of 5 is used and is updated if it 
is exceeded. 



The following report type, which is generated when a system 
milestone occurs, is supported by the R07.1 software release and 
higher. It is only applicable to the operation of the Model 
3200MPS System. 



Report Type 6 - APU signal queue reached its depth, 



Format : 



031-27 



mon/dd/yy hhiirantss APU SIGNAL QUEUE REACHED DEPTH n 



Fields: 



APU SIGNAL. 
QUEUE REACHED 
DEPTH 



n is the depth of the APU signal queue 
at the time of error recording. An initial 
depth of 11 is used and is updated if it is 
exceeded . 



5.7.1.5 Memory Errors 

The following is the memory report generated when a memory error 
occurs on all Perkin-Elmer systems except the Model 3205. The 
module data is omitted if a memory configuration definition file 
was not specified. 



Format 

031-28 



mon/dd/yy hh:mm:ss MEMORY ERROR 
CHIP-ccc-ch MODULE y-zzz 



BLOCK=mS, BANK=n, SU-x, 
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Fields: 



BLOCK= 



m is the 
through F) 
included if 



block number in hexadecimal (0 
where the error occurred. S is 
the block is shared memory. 



BANK= 



n is the bank number 
occurred. 



(0 to 3) where the error 



SU= 



X is the storage unit 
error occurred. 



in memory where the 



CHIP= 



ccc is the alphanumeric column identifier 
where the error occurred. This identifier is 
identical to those printed on each memory 
board (SDSTM - A or B; DDSTMS - AA, AB, AC or 
AD) . 



ch is the chip number (0 through 38) where the 
error occurred. This field can also contain 
asterisks (**), indicating that a multiple 
error occurred. Individual errors follow 
immediately on the report. 



MODULE 



y is the module count using the order in which 
modules were defined in the bank. 



zzz is the functional 
F02, F03, F04). 



variation (e.g., FOl, 



If the Error Reporting Utility is executing 
System, the rejport has the following format. 



on 



Model 3205 



Format 

031-29 



mon/dd/yy hh:mm:ss MEMORY ERF;OR ROW=r CHIP=c 



Fields: 



ROW= 



r is a numeric value (0 through 32) indicating 
the row number of the chip where the error 
occurred. 



CHIP= 



c is an alphanumeric value indicating which 
chip in the row has failed. Valid values are 
through 15 for data bits and CO, CI, C2, C4 
and C8 for check bits. 
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5.7.2 Summary Reports 

There are three types of summary reports: 

• System errors and milestones 

• Device errors 

• Memory errors 

5.7.2.1 Summary of System Errors and Milestones Report 

Error types itemized by taskname will be itemized for a maximum 
of nine tasknames. Additional errors of the same type, but 
different tasknames, are listed under the category ALL OTHER 
TASKS. Error types itemized by APU number indicate the number of 
occurrences of the error for each APU within the Model 3200MPS 
System. 

Format: 



031-30 



SYSTEM QUEUE FULL - POSSIBLE 


OVERFLOW bbb 


APU SIGNAL QUEUE FULL - 


POSSIBLE 


ccc 


OVERFLOW 








ERROR RECORDING INTERRUPTED 




ddd 


MAXIMUM SYSTEM QUEUE DEPTH REACHED 


ggg 


MAXIMUM APU SIGNAL QUEUE 


DEPTH 


hhh 


REACHED 








TASK QUEUE OVERFLOWS 








taskname 1 






nnnnnn 


taskname 2 






nnnnnn 


taskname 3 






nnnnnn 


taskname 9 






nnnnnn 


ALT, OTHER TASKS 






yyyyyy 


UNSPECIFIED SQS ROUTINE 








taskname 1 






nnnnnn 


taskncune 2 






nnnnnn 


taskname 3 






nnnnnn 


taskname 9 






nnnnnn 


AIT, OTHER TASKS 






yyyyyy 
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UNSPECIFIED ESR ROUTINE 

taskname 1 
taskname 2 
taskname 3 



taskname 9 

ALL OTHER TASKS 

REMOVE APU WAIT ERROR 



APUSl 
APU#2 
APU»3 



APU»9 

APU )RELEASE RESOURCE ERROR 

APU»1 
APU»2 
APU#3 

APU#9 

CPU IRECEIVE QUEUE EMPTY ERROR 

CPU ]RECEIVE QUEUE LOCKED ER]ROR 

APU EXECUTION QUEUE LOCKED ERROR 

APU NO RESPONSE ERROR 

APUttl 
APU#2 
APUtt3 

APU»9 

RTSM RECEIVE PARITY ERROR 

APU»1 
APU»2 
APU»3 

APUtt9 



nnnnnn 
nnnnnn 
nnnnnn 



nnnnnn 

yyyyyy 



nnnnnn 
nnnnnn 
nnnnnn 



nnnnnn 



nnnnnn 
nnnnnn 
nnnnnn 



nnnnnn 

JiH 

kkk 

111 

nnnnnn 

nnnnnn 
nnnnnn 
nnnnnn 

nnnnnn 



nnnnnn 
nnnnnn 
nnnnnn 



nnnnnn 
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Fields: 



*SYSTEM QUEUE 
FULL- 
POSSIBLE 
OVERFLOW 



bbb is a decimal number indicating the total 
number of times the system queue was full. 



*APU SIGNAL 
QUEUE FULL- 
POSSIBLE 
OVERFLOW 



ccc is a decimal number indicating the total 
number of times the APU signal queue was full. 



ERROR 

RECORDING 

INTERRUPTED 



ddd is 
number 
rupted 



a decimal number indicating the total 
of times error recording was inter - 



MAXIMUM SYSTEM ggg is a decimal number indicating the maximum 

QUEUE DEPTH system queue depth reached. 

REACHED 



*MAXIMUM APU 
SIGNAL QUEUE 
DEPTH REACHED 



hhh is a decimal number indicating the maximum 
APU signal queue depth reached. 



taskname 1 . 
taskncime 9 



nnnnnn is a 
total errors. 



decimal number indicating the 



ALL OTHER 
TASKS 



yyyyyy is a decimal number indicating the 
total number of errors for all tasks not 
reported individually for each type of system 
error . 



*APUttl. 
APU#9 



nnnnnn is a decimal number indicating 
total errors recorded for each APU. 



the 



*CPU RECEIVE 
QUEUE 
EMPTY 



J3j is a decimal number indicating the total 
number of times the CPU task receive queue was 
found to be empty in error. 



*CPU RECEIVE 
QUEUE LOCKED 



kkk is a decimal number indicating the total 
number of times the CPU task receive queue was 
locked in error . 



*APU EXECUTION 111 is a decimal number indicating the total 
QUEUE LOCKED number of times the APU execution queue 
locked . 



* These 
us ing 



messages 
APUs. 



are only applicable to Model 3200MPS Systems 
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5.7.2.2 Summary of Device Errors 

Device error smmmaries are itemized for a maximum of nine devices 
and nine device addresses. Additional errors are included under 
the category ALL OTHER DEVICES. Additional I/O errors are 
included under the category ALL OTHER I/O ERRORS. 



Example: 



031-32 


DEVICE device namel 






BIT MAP ALUDCATION ERRORS 


nnnnn 




BIT MAP DEALJLOCATE ERRORS 


nnnnn 




DIRJ2CT0RY BLOCK ERRORS 


nnnnn 




DIRECTORY ENTRY ERRORS 


nnnnn 




INDEX/DATA BLOCK ERRORS 


nnnnn 




DEVICE device name9 






BIT MAP AT .LOCATION ERRORS 


nnnnn 




BIT MAP DEALT £)CATE ERRORS 


nnnnn 




DIRECTORY BLOCK ERRORS 


nnnnn 




DIRECTORY FILE ERRORS 


nnnnn 




INDEX/DATA BLOCK ERRORS 


nnnnn 




ALL OTHER DEVICES 






BIT 14AP ALTiOCATION ERRORS 


nunmmm 




BIT MAP DEAT,r.OCATE ERRORS 


mnunmm 




DIRECTORY BLOCK ERRORS 


mnvnmm 




DIRECTORY ENTRY ERRORS 


mnunmin 




INDEX/DATA BLOCK ERRORS 


nuTunmm 




I/O ERRORS 






DEVICE NAME ADDRESS 


I/O ERRORS 




xxxx YYYYYYT/ 


bbbbbbbb 




xxxx yyyyyyrr' 


bbbbbbbb 




xxxx YT/YYTr/ 


bbbbbbbb 




xxxx YYYYYYr/ 


ssssssss 




ALT, OTHER I/O ERRORS 






^ 
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Fields: 



device namel. 
device naine9 



are the names of up to nine devices on 
which the errors occurred. 



nnnnn 



is a decimal number indicating the total 
number of errors occurring in five 
categories for the specific device. 



ALL OTHER 
DEVICES 



mmmm is a decimal number indicating the 
total number of errors occurring on 
additional devices. 



DEVICE 
NAME 



xxxx is the naime of up to nine devices on 
which the I/O errors occurred. 



ADDRESS 



yyyyyyyy is the address of the device 
where the error occurred. 



I/O ERRORS 



ALL OTHER I/O 
ERRORS 



bbbbbbbb is a decimal number indicating 
the total number of I/O errors occurring 
on the specific device. 

ssssssss is a decimal number indicating 
the total number of additional I/O 
errors. 



5.7.2.3 Memory Errors Summary Report 

Memory errors are broken down by module and functional variation 
only if an MCD file was specified. 



Example: 



Fields: 



BLOCK 
mS 



BANK 
n 



STORAGE 
UNIT 
X 



PHYSICAL 
MODULE 
x-Fnn 



CHIP 
ccc-ch 



NUMBER 
OF FAILURES 
nnhn 



BLOCK 



m is the block number in hexadecimal (0 
through F) where the error occurred. S is 
included if the block is shared memory. 
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BANK 



n is the bank (0 through 3) 
occurred. 



where the error 



STORAGE 
UNIT 



X is the storage unit in memory where the 
error occurred. This information is not 
displayed if module information was defined in 
an MCD file. 



PHYSICAL 
MODULE 



X is the physical module number 
bank where the error occurred. 



within the 



Fnn is the functional variation (e.g., FOl, 
F02, F03, F04) of the module where the error 
occurred. 



CHIP 



ccc is the alphanumeric column identifier 
where the error occurred. This identifier is 
identical to those printed on each memory 
board (SDSTWI - A or B; DDSTM - AA, AB, AC or 
AD). An M preceding the column ID indicates 
multiple errors. 



ch is the chip number (0-38) where the error 
occurred. This field also can contain 
asterisks (**) , indicating a multiple error. 
Individual errors follow immediately on the 
report. 



NUMBER 

OF FAILURISS 



nnnn is a decimal number indicating the total 
number of memory errors occurring within the 
b lo cks d i s p lay ed . 



The following memory errors summary report is generated 
Model 3205 System. 



for the 



Example: 



031-34 







NUMBER 


ROW 


CHIP 


OF FAILURES 


r 


c 


nnnn 



Fields: 



ROW 



r is the row number of the chip where the 
error occurred. The row number will be in the 
range of to 32. 
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I CHIP c is an alphamumer ic value indicating what 

I chip in what row has failed. Valid values are 

I through 15 for data bits and CO, CI, C2, C4 

I and C8 for check bits. 



NUMBER nnnn is a numeric value indicating the number 
OF FAILURES of failures. 

5.8 SAVING INFORMATION TO AN ARCHIVAL FILE 

The SAVE command saves the error report to an archival file. 

Format: 

SAVE fd Qnew] 

Parameters: 

fd is the file descriptor of the device to which 

the report is saved. This fd must be 
specified as a magnetic tape device or an 
indexed file. The report is appended to 
existing data in the specified fd unless the 
NEW parameter is specified. 

NEW specifies that the report is to be saved at 

the beginning of the file or tape. 

Functional Details: 

If NEW is not specified and if a magnetic tape device is 
specified as the fd, the selected error information is appended 
to the existing archive by writing over the first filemark 
encountered on the tape. When appending to a multiple volume 
file, only the last tape should be mounted. If an indexed file 
is specified as the fd, the selected information is appended to 
the file. 

If NEW is specified and an indexed file is specified, the indexed 
file is allocated with 256-byte records and an index block size 
and data block size of 1. For both magnetic tape and indexed 
files, header information is written to the first record in the 
archival file. 

If the specified fd is a magnetic tape and multiple volumes are 
required, an end of tape label is written and the message MOUNT 
NEXT TAPE is output to the console. The task pauses, allowing 
the operator to mount the next tape. After mounting the next 
tape, the operator continues execution by entering the command 
CONTINUE. Multiple tape handling formats are compatible with 
OS/32 Copy multiple tape processing. 
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5.9 PAUSING A TASK 

The PAUSE conuviand pauses execution of the Error Reporting Utility 
and returns control to the operating system. 

Format: 

JEAUSE 

5.10 ENDING A TASK 

The END command terminates execution of the Error Reporting 
Utility. 

Format : 

END 

5.11 MESSAGES 

CANNOT ALL.OCATE fd 

indicates that allocation of the file nsimed in a SAVE or 
DEFINE! command failed because the volume was incorrect or 
protected, 

CANNOT ASSIGN fd 

indicaites that requested access privileges could not be 
granted or the file had nonzero protection keys. 

fd NOT FOUND 

indiccites that the specified file does not exist. 

fd NOT INDEXED FILE OR MAGNETIC TAPE 

indicates that the argument of a SAVE command is not an 
indexesd file or a magnetic tape. 

FILE fd AI.READY EXISTS 

indicates that a file named in a SAVE command as NEW 
already exists, or that the file naimed in the DEFINE 
command entered already exists. 
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INVALID ARGUMENT SEPARATOR 

indicates that the second argument was not preceded by a 
coinina. 



INVALID COMMAND 

indicates that the last command read was not recognized 
as a valid command. 



INVALID HEADER ON fd 

indicates that pointers in the header do not point to 
valid records or are not zero. 



INVALID KEYWORD 

indicates that an argument of the last command was not a 
valid keyword for that command or was used more than once 
in the same command. 



INVALID OR MISSING DATA 

indicates that the argument of a FROM or TO parameter in 
the last SELECT command was invalid or missing. 



INVALID OR MISSING FILE DESCRIPTOR 

indicates that the first parameter entered was not valid. 

INVALID TIME INTERVAL 

indicates that the last FROM date is later than the last 
TO date at the time of a REPORT or SAVE command. 

NO INPUT FILE 

indicates that a SELECT, REPORT or SAVE command cannot be 
processed because a previous GET command was not issued. 

NOT ENOUGH SYSTEM SPACE 

indicates that during allocation or assignment, the task 
exceeded its system space limit or there was not enough 
system space available. 
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MEMORY ERROR/MCD CONFLICT 

indlceites a memory error that does not fit the defined 
memory configuration is encountered. 
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CHAPTER 6 
DISK DUMP UTILITY 



6.1 GENERAL DESCRIPTION 

The Di3k Dump Utility provides facilities for: 

• Dumping the information from a disk volume to a magnetic tape 
and verifying that the data is correctly dumped. 

• Restoring a previously dumped disk volume from magnetic tape 
to a disk volume and verifying that the data is correctly 
restored. 

• Displaying the information contained on a disk volume in a 
format useful for debugging system routines that manage direct 
access volumes. 

CAUTION 

DISK DUMP IS NOT SUITABLE FOR BACKING UP 
A DISK BECAUSE IT WILL DUMP TO A BAD 
SECTOR IP INSTRUCTED TO DO SO. ANY 
DEFECTIVE SECTORS ON A DISK PACK CAN 
RISSULT IN LOSS OF DATA. IT IS 
RISCOMMENDED THAT BACKUP OR FASTBACK BE 
USED FOR SAVING FILEIS. 

6.2 DISK DUMIP UTILITY REQU I REMEINTS 
The Disk Dump Utility requires: 

• 9kb of memory - When using the DUL and UDL commands r an addi- 
tional buffer is necessary. The size of the buffer depends on 
the record length as specified in the RECORD command. 

• any currently supported disk device. 

The Disk Dump Utility is provided for the user in object format. 
It must be built as a privileged user task (u-task) using Link. 
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The Disk Dump Utility requires n*256 bytes of memory for use by 
the UDL and DUL commands. The value of n is set by the RECORD 
command. The default for n is 48. Therefore, at a minimum. Disk 
Dump requires 48*256 bytes of workspace if the DUL or UDL 
commands are to be used and twice that amount of buffer space for 
the verify option. 

6.3 OPERATING PROCEDURES 

To execute the Disk Dump Utility, follow this procedure: 

1. Load the Disk Dump Utility using the LOAD command. 

2. Select the Disk Dump Utility as the current task using the 
TASK command . 

3. Assign logical units using the ASSIGN command as follows: 

• Disk device to logical unit 1 (lul) 

• Binary input/output (I/O) device to lu2 

• ASCII output device; e.g., printer to lu3 

• Command input device to lu5 

4. Start the Disk Dump Utility using the START command. 
Format: 



START 



When the program is started, the following message is 
displayed on the console: 



OS/3 2 DISCDUMP Rxx-yy 



Where xx is the current revision level of the prograim and yy 
is the number of updates within this revision. 
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MOTE 



Earlier versions 
and Dump Pr int 
with current ve 
system. For 
executing a 5.2 r 
print of the disk 
appropr iate 5.2 r 
task on the 7.2 o 
OS/32 system. 



of the Disk Dump Utility 
Utility are compatible 
rsions of the OS/32 
exciinple, if you are 
evision level panic dump 
file, you would use the 
evision level panic dump 
r higher revision level 



The user should be familiar with the file manager to 

interpret the output of the different types of dumps. The 

following commands dump various file management data to the 
ASCII output device (lu3). 



Format: 



yOLUMJE 



Information displayed: 



VOLN: 
ATRB: 
FDP: 
MAP: 



Volume ncime of disk 

Attributes 

Pointer to first directory block 

Pointer to bit map 



Format: 



DIRECTORY 



Information displayed: 



FNM: 

EXT: 

ACT: 

FLBA: 

LLBA: 



Filename 

Extension 

Account number 

First logical block address of file 

Last logical block address of file 
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LENGTH : 



KEYS 
RCNT 
WCNT 
ATRB 
BKSZ 

CSEC; 



TIME 
ALLOC: 

TIME 
WRITTEN; 



Record length ( indexed or nonbuf f ered 
indexed file) or size of file (contiguous 
or extendable contiguous file) 

Read/wr ite keys 

Read count 

Write count 

File type (attributes) 

Block size (index/data block size for 
index files) 

Logical record length for indexed files or 
pointer to last record accessed on 
contiguous files 

Date and time of allocation 
Date and time of last change 



Format: 



BIT 



Information displayed: 



BIT MAP DUMP: Free and allocated sectors in bit map 



Format; 



F-ILES [jd] 



Information displayed: 



SECTORS : 



The sectors occupied by the specified file 
are displayed. If fd is omitted, all 
files are dumped including sectors 
occupied by the volume descriptor, bit map 
and directory blocks. 
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6. This cornmcmd dumps disk data by filename or sector 



Format : 



DUH 
DUA 
DUS 
DUL DG 



'SJECTOR=st adr Q end adf]' 



EJ)=f i leneune . ext 



Parameters: 



DUH 

DUA 
DUS 

DUL 

st adr 

end adr 



f i len£une . ext 



dumps hexadecimal and ASCII to lu3 , the 
list device. 

dumps ASCII to lu3, the list device. 

dumps 256 bytes (sector) binary to lu2, 
the binary output device. 



dumps multisector binary to lu2, 
binary output device. 



the 



is the starting hexadecimal 
address. The default is 0. 



sector 



is the ending hexadecimal sector address. 
If this parameter is omitted, only one 
sector is dumped. 

dumps only those sectors that are 
allocated in the bit map. The * option 
dumps only those blocks of sectors with at 
least one sector allocated, where the 
block is defined by the RECORD command. 
The default is 48 (one cylinder for a 
2.5Mb or 5Mb disk). 

is the file descriptor (fd) of a 
contiguous or indexed file. The program 
dumps only the sectors occupied by that 
file. 
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Exounples : 



The following excimple dumps sectors through 10 in 
hexadecimal and ASCII to lu3 . 



DUH SECTOR=0,10 



The following example dumps sector 1 in hexadecimal and ASCII 
to lu3 . 



DUH SECTOR=l 



The following example dumps to lu3 , in ASCII, all sectors 
occupied by file RUN. CSS. 



DUA F=RUN.CSS 



The following example dumps all sectors in ASCII to lu3 



DUA 



The following example dumps binary to lu2 sectors marked as 
allocated in the bit map. 



DUS * 



The following example dumps all blocks of sectors to lu2 . 



DUL, 



The following example dumps to lu2 only those blocks of 
sectors with at least one sector allocated. 



DUL * 
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The UNDOMP command is the inverse of the DUMP conunand. 
Records are read from lu2 and written to the disk as 
specified. 



Format : 



UDS 



7 ajaCTOR^st adrQend adr] 



UDL Q*] 



Pareuneters; 



UDS 



UDL 



st adr 
end adr 



dumps 2 56 bytes (sector) binary from lu2, 
the binary output device. 

dumps multisector binary from lu2, the 
binary output device. 

is the starting hexadecimal sector 
address. The default is 0. 

is the ending hexadecimal sector address. 
If this parsimeter is omitted, only one 
sector is dumped. 



Functional Details: 

A disk should only be dumped to and restored from the same 
type of disk. That is, a 16Mb disk should not be dumped to 
a 67Mb or 256Mb disk, and vice versa. 



Examples : 

The following example reads a sector from lu2 and writes it 
to the disk as sector 0. 



UDS SEC=0 



The following example causes the first record to be read from 
lu2 and written, starting at sector 0. It becomes the volume 
descriptor for the pack. The bit map is read sequentially 
from lu2, and all sectors marked as allocated are read 
sequentially and written to the disk. 
UDS * 
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The following example causes the first record to be read from 
lu2 and written, starting at sector 0. The bit map is 
searched for blocks of sectors with at least 1 sector 
allocated. Such blocks are sequentially read from lu2 and 
written onto the disk. The number of sectors per block can 
be specified by the RECORD command. The default is 48. 



UDL * 



The VERIFY command is used with the DUMP/UNDUMP commands. 
The VERIFY command should be used following all binary DUL 
and UDL operations. Any sectors between lul and lu2 that do 
not match are printed in hexadecimal format. 



Format: 



VERIFY * 



Parameters: 



verifies all allocated sectors between two 
logical units. This option is available 
after DUL * or UDL * operations only. 



Functional Details: 
The lu assignments are: 

• lul indicates disk. 

• lu2 indicates disk or magnetic tape. 



If lu2 is assigned to a magnetic tape, the tape must be 

precisely positioned. The following commands are provided to 

support the positioning of the magnetic tape from within the 
progrsun: 



COMMAND 

EEWIND lu 
EW lu 
W.IL.E lu 
E£ILE lu 
EEILE lu 
JBfiECORD lu 
ZRECORD lu 



FUNCTION 

Rewind 

Rewind 

Write filemark 

Forward to end of file 

Backspace to beginning of file 

Backspace record 

Forward space record 
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The following 
Utility: 



commands can be used with the Disk Dump 



COMMAND 
MIDTH n 



KECORD n 



FUNCTION 

sets width of print line to n, where n is a 
decimal number between 10 and 132. The 
default width is determined by a fetch 
attribute of lu3 . If this fetch returns a 
zero record length or one larger than 132, the 
width is set to 72. Otherwise, the default 
width used is the logical record length 
returned from the fetch attributes call. This 
command is invalid if output is spooled. See 
Chapter 2 for information on OS/32 Spooler. 

sets the record length for the UDL, DUL and 
VERIFY cominands, where n is the number of 
sectors per record. The default value for n 
is 48. The allowable values for n are between 
2 and 4096, inclusive. A buffer of n*256 
bytes is required for the operation of the UDL 
and DUL commands. Twice the buffer is needed 
for VERIFY. 



£AUSE 
END 



pauses the Disk Dump Utility. 

terminates the Disk Dump Utility 
supervisor call 3 (SVC3) code 0. 



by 



Messages : 



COMMAND ERROR 

indicates that an invalid operator command, option or 
operand is read from the command input device (lu5). 
Another command is then read from lu5. 



DEVICE NOT DISC 

indicates that the device assigned to lul is not a disk 
device or is an unsupported type of disk. The prograuti 
pauses. 



DISCDUMP Rxx-yy 

indicates that the program is operational and ready for 
command input. The current revision level is xx; yy is 
the update level. 
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FILE NOT WRITTEN ON YET 

indicates that a dump is requested for an indexed file on 
which no data has been written. Another conunand is read 
from lu5. 



10 ERROR ssdd 

indicates that nonzero status is returned on an I/O 
operation to a nondisk device. The device- independent 
status is ss; dd is the device-dependent status. The 
program pauses. 

10 ERROR ssdd LBA =nnnnnn 

indicates that nonzero status is returned on a disk I/O 
operation. The SVCl device- independent status is ss; dd 
is the SVCl device-dependent status; nnnnnn is the 
logical sector address. If the status is CO (illegal 
function), AO (device unavailable) or 81 (unassigned lu), 
the task pauses. When the task continues, the operation 
is retried. If the status is 90 (end of medium), the 
command is terminated and another command is read from 
lu5. For any other SVCl status, the I/O operation is 
retried 10 times before the message is logged; another 
command is then read from lu5. 



MEM-FUti. 

indicates insufficient memory to set up a buffer used by 
the DUL and UDL commands. The program reads the next 
command . 



OS/32 Rxx-yy REQUIRED 

indicates that Disk Dump is being run on an incompatible 
operating system. Revision xx-yy or higher is required. 
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CHi\PTER 7 
DUMP PRINT UTILITY 



7.1 GENERAL, DESCRIPTION 

The Dump Print Utility interprets and prints to a list device the 
contents of the memory dump previously copied from memory to 
magnetic tape by the panic dump prograjm. The Dump Print Utility 
pr ints : 

• System data structures (STRUGS) 

• System journal entries 

• Contents of memory 

The Dump Print Utility requires the following system resources: 

• OS/32 

• 18.25kb of memory in addition to that of the operating system 

• A disk device 

• A list device (high-speed line printer is recommended) 

The Dump Print Utility can print the contents of a memory dump 
from magnetic tape or a disk device by copying it to a temporary 
file and then to a list device, or copying it to a permanent file 
and then to a list device. 



NOTE 

The dump print task relates to the 
particular OS/32 system from which you 
are printing. For example, if you are 
executing a 5.2 revision level panic dump 
print of the disk file, you would use the 
appropriate 5.2 revision level panic dump 
task on the 7.2 or higher revision level 
OS/32 system. 
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7.2 USING A TEMPORARY OR PERMANENT FILE 

If a temporary file is used, it is allocated by the utility and 
automatically deleted at the end of task. However, if a 
permanent file is used, it must be allocated by the user as an 
indexed file with 256-byte records and assigned to logical unit 
2 (lu2). 

Copying the contents of the memory dump to a permanent file 
allows the user to subsequently restart the utility to print 
multiple copies or to modify a corrupted area so it can be 
interpreted and printed. 

7.3 EXECUTING THE DUMP PRINT UTILITY 

To print the contents of a memory dump from magnetic tape, enter 
the following sequence of commands: 

LOAD dump print utility 
TASK dump print utility 
START 



To print the contents of a memory dump from a disk, the Dump 
Print Utility will accept any file descriptor (fd) as a response 
to the input device request. 

The program prompts the user for the files and options required 
to produce the dump. A syntax or fd error entered as a response 
causes the prompt to be repeated. 

Prompt: ENTER MAGTAPE (INPUT) FD:> 

Response: fd 

fd is the file descriptor of the magnetic tape or disk file 
containing the memory dump to be printed; e.g., MAGI:. This 
fd is automatically assigned to lul. 



NOTE 

This prompt is not issued if lul was 
preassigned to a permanent disk file. 

Prompt: ENTER LIST DEVICE FD:> 

Response: fd 

fd is the file descriptor of the list device on which the 
memory dump is to be printed; e.g., PR:. This fd is 
automatically assigned to lu3 . 
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Prompt: 
Response: 



DUMP ALL?> 

/yes) 
Ino I 



If the user response is YES, the program displays the system 
journal, all operating system structures, and all memory until 
the end of operating system code to the list device. If the 
user response is NO, the following prompts are displayed: 



Prompt: 
Response: 



dump strugs ?> 
(yes) 

I NO / 



If the user response is YES, the operating system structures 
are interpreted and dumped. If the user response is NO, no 
operating system structure dump is produced. Regardless of 
whether the answer to this prompt is YES or NO, the following 
prompts are displayed: 



Prompt: 
Response: 



DUMP JOURNAL?) 



/ YES)^ 
tNO / 



If the user response is YES, the operating system journal is 
formatted and dumped (if present). If the user response is 
NO, the journal dump is not produced. 



Prompt: 
Response: 



DUMP MEMORY ?> 



( YES) 
I NO / 



If the user response is NO, the previously requested data is 
printed on the list device. If the user response is YES, 
this prompt is displayed: 



Prompt: 
Response; 



ENTER PRINT RANGE (LOLIM, HILIM) ?> 



st mem adr' 

iil 

SXSTEM 



end mem adr 1 
;top of i&eift03fy)_ 
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Where: 



at mem adr 



end mem adr 



is the starting memory address of the range 
whose contents are to be printed on the list 
device. The default starting address is X'O'. 

is the ending memory address of the range 
whose contents are to be printed on the list 
device. The default ending address is top of 
memory (MTOP) . 



OS 



specifies that all memory occupied by the 
operating system is to be printed on the list 
device. 



SYSTEM 



specifies that all memory defined as system 
space is to be printed on the list device. 



NOTE 

The command input device defaults to the 
console (CON:) and is automatically 
assigned to lu5. The temporary file is 
a default and is automatically assigned 
to lu2. If no values are specified and 
a carriage return is entered, all memory 
is assumed. 



After these user responses are entered or lu assignments are 
made, the contents of the memory dump on magnetic tape are copied 
to the temporary file or permanent file. If the contents of the 
specified range are corrupt and cannot be interpreted, an error 
message is displayed. After the Dump Print Utility dumps as much 
memory as it can, the following prompt is displayed: 



Prompt: 
Response: 



DUMP MORE MEMORY? > 



YES 
NO 



If the user response is NO, the Dump Print Utility 
terminates. If the user response is YES, the prompt sequence 
starting with ENTER PRINT RANGE (LOLIM, HILIM) : > is displayed 
again. 
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7.4 DUMP PRINT EXAMPLE 

The following example dialogue executes the Dump Print Utility: 



*LOAD .BCOrjMPRINT 

*TASK .BG 

* START 

OS/32 DUMPPRINT nn-nnn Rxx-yy 

ENTER MAG TAPE (INPUT) FD:>MAG1: 

ENTER LIST DEVICE FD:>PR: 

DUMP ALL?>NO 

DUMP STRUGS? >N0 

DUMP JOURNAL?) YES 

DUMP MEMORY ?> YES 

ENTER PRINT RANGE (LOLIM, HILIM) : >0S 

DUMP MORE MEMORY?) YES 

ENTER PRINT RANGE (LOLIM, HILIM) : >SYS 

DUMP MORE MEMORY ?> YES 

ENTER PRINT RANGE (LOLIM, HILIM) : >2C200 , 3EEEFE 

DUMP MORE MEMORY? > NO 

.EG - END OF TASK CODE = CPU TIME = n.nnn/n.nnn 



Appendix A contains a sample display from the Dump Print Utility 
in effect for release R06.2 and higher corresponding to the 
dialogue above. Another example of a Dump Print Utility dialogue 
follows : 



*LOAD .BG,DUMPRINT 

*TASK .BG 

* START 

OS/32 DUMPRINT nn-nnn Rxx-yy 

ENTER MA.GTAPE (INPUT) FD:>MAG1: 

ENTER LIST DEVICE FD:>M300: CRSHDUMP.TXT 

DUMP ALL.? > YES 

END OF I'ASK 

.BG - ENID OF TASK CODE= CPU TIME = n.nnn/n.nnn 



Appendix B contains fragments of a sample display from the Dump 
Print Utility, in effect for software release R07.2 and higher, 
corresponding to the dialogue above. The dump print display 
contained in Appendix B is from a Model 3200MPS System. 
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7.5 CORRUPT SYSTEM POINTER TABLE (SPT) 

If the halfword address at location X'62', which points to the 
SPT, or the SPT itself is corrupt, the following message is 
displayed: 

POINTER TO SPT INVALID - X'62' 
ENTER A (SPT.INIT) - ELSE '•N0''> 

The user is given the option to enter the valid address of the 
SPT, which is labeled SPT.INIT in the operating system map. If 
the SPT is corrupt, the user can enter NO to continue. If NO is 
entered, the task control block (TCB) table and segment control 
list (SCL) are not produced. 

7.6 DUMP PRINT STRUCTURE DISPLAY 

The following sequence of structure display is in effect for the 
I Dump Print Utility, release R07.2 and higher, for all processors. 
I Please note differences for the Model 3200MPS System. 

• SPT 

• TCB followed by its context block (CTX) for each task assigned 
to the central processing unit (CPU) 

I • For each APU queue parcuneter block (QPB) in a Model 3200MPS 
I System, the TCB and its associated CTX for each task assigned 
I to the QPB, followed by the QPB 

• TCBs and their associated CTXs for all tasks in the TCB table 
I not already output 

I • An auxiliary processor block (APB) for each APU in a Model 
I 3200MPS System 

• Segment descriptor entries (SDEs) for any pure segments in the 
SCL 

• A device control block (DCB) followed by its associated CTX 
(if any) for each device in the system 

• A volume mnemonic table (VMT) 

• Coordination nodes (EVNs) 
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NOTE 

For systems other than the Model 3200MPS, 
no APBs or QPBs will be output. All TCBs 
are assigned to the CPU; therefore, all 
TCBs will be output following output of 
the SPT. 



The display of structure output includes both hexadecimal and 
ASCII representation. The ASCII representation will be displayed 
on the far right of the report with a maximum of 3 2 characters. 



7 . 7 AUX I L I ARY PROCESS I NG 
(QPB) SUMMARY DISPLAY 



UNIT (APU) QUEUE PARAMETER BLOCK 



This summary page will be displayed following the display of the 
floating point registers. Output of the summary will be 
contingent upon finding a nonzero quadword aligned address in the 
SPT.QPBO field of the SPT. Following are the summary contents. 



TITLE 
ID 



DUMP OF QPB INFORMATION 

This field contains the queue ID from the 
QPB. ID field of the current QPB. 



ADDR 



This field contains the hexadecimal address of 
the QPB. 



STATUS 



This field displays the queue 
status. 



process mg 



APUS 



This field displays the APU assignment bitmap 
in hexadecimal form. The bit number of the 
bitmap corresponds to the number of the APU 
assigned to the queue. 



QUEUED 



This field displays the number of tasks on the 
queue as contained in the respective counter 
in the QPB. 



MAPPING TASK 



This field displays the TCB.ID of a task 
granted mapping rights (via SVC13) to the 
queue. The word NONE will be displayed if no 
task is assigned control r ights - 



EXCL.TASK 



This field displays the TCB.ID of the 
holding exclusive rights to the queue. 



task 
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Example of the APU queue summary: 



DUMP OF QPB INFORMATION 

ID ADDR STATUS APUS QUEUED MTID XT ID 

09C0 1098 1000 1 OOOF OOOF 

JL \J 7 Jl!* \J ••■■ •■■■ • •••■ •••■ 



7.8 AUXILIARY PROCESSING UNIT (APU) AUXILIARY PROCESSOR 
BLOCK (APE) SUMMARY DISPLAY 

This summary page will be displayed following output of the 
floating point registers. Output of the APB summmary page is 
contingent upon finding nonzero values at locations X'CO' and 
X'C4'. Following are the summary contents. 



TITLE 
ID 



DUMP OF APB INFORMATION 

This field contains the APU number 
APB. ID field of the current APB. 



from the 



ADDR 



STATUS 



This field contains the hexadecimal address of 
the current APB. It must be quadword aligned 
or the word INVALID will be output in this 
field and no further fields for the APB will 
be processed. 

This field displays the APU state as contained 
in the APB. STAT field of the current APB. 



CTCB 



STATE 



This field displays the address of the current 
TCB contained in the APB. CTCB field of the 
current APB. If the address is not quadword 
aligned, the message INVALID is displayed and 
no further fields for this APB are processed. 

This field will display internal state 
information for the APU contained in the 
APB.FLGS field of the current APB. 



QUEUE 



CONTROL TASK 



This field will display the address of the QPB 
to which the APU is assigned. The address is 
contained in the APB.ARQP field. If this 
address is not quadword aligned, the word 
INVALID will be displayed in this field. 

This field will display the TCB. ID of the task 
granted control rights (via SVC13) for this 
APU. The word NONE will be displayed if no 
task is assigned control rights. 
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WAIT TASK This field will display the TCB.ID of the task 

on which this APU is "waiting" for completion 
of fault servicing. The word NONE will be 
displayed if there is no task wait on the APU. 

Example of the APB summary report: 

DUMP. OF APB INFORMATION 

ID ADDR STATUS CTCB STATE QUEUE CTID WRID 

1 07CCI FFFF FE37C0 AOOOOOOl E7C890 NONE 0010 

2 08FF 

7.9 DUMP PRINT MESSAGES 

ADDRESS OUT OF RANGE: address 

indicates that an invalid address pointer was encountered 
while processing the system STRUGS. 

ASGN-ERR 

indicates that lu is already assigned or off-line. 

BUFF -ERR 

indicates there is no room in the system for file control 
block (FCB) and/or buffers. 

FD-ERR 

indicates a file descriptor error. 

ILFN-ERR 

indicates an illegal function or illegal file type. 

INVALID TAPE FORMAT 

indicates that the magnetic tape was created by an 
operating system not compatible with the current version 
of the Dump Print Utility program. 

LU-ERR 

indicates an illegal logical unit. 
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NAME -ERR 



indicates that the specified filename and extension do 
not exist. 



POINTER TO SPT INVALID-CANNOT DUMP OS 

A dump of operating system memory was requested but the 
memory range of the operating system cannot be determined 
because the SPT is corrupted. 



POINTER TO SPT INVALID-CANNOT DUMP SYSTEM SPACE 

A dump of system space memory was requested, but the 
memory range of system space cannot be determined because 
the SPT is corrupted. 



PROT-ERR 

indicates invalid protection keys. 

SIZE-ERR 

indicates invalid logical record length or not enough 
space on disk for the file. 

SYNTAX ERROR 

indicates a syntax error in fd. 

TYPE-ERR 

indicates a nondirect access device or a device is marked 
off-line. 

VOL-ERR 

indicates a volume error; no such volume or device exists 
in the system. 

****ssdd I/O ERROR 

indicates that an I/O error occurred. ss is the 
device- independent status byte from the standard SVCl 
parameter block; dd is the device-dependent status byte. 
See the OS/32 Application Level Programmer Reference 
Manual. 
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CWVPTER 8 
MIRROR DISK SYNCHRONIZATION UTILITY 



8.1 MIRROR DISK FACILITY 

The mirror disk facility ensures continued operation of the 
system, without operator intervention, following a disk failure 
by automatic maintenance of pairs of disks in physical 
synchronization. It provides for automatic continuation, on-line 
resynchronization and uninterrupted availability of data while 
being trcinsparent to users. It also allows for orderly 
reconfiguration through operator requested switching of mirrored 
disks. 

When the operating system is informed by the MARK ON command that 
there are to be mirror disks, it directs all writes to two disks. 
This not only includes writes to the files, but also file 
allocation, file renaming, etc. No program changes are required. 
Reads continue to be scheduled from one of the disks. When 
mirror disks are present, this read disk is called the primary 
disk. The other partner of the pair is called the secondary 
disk. 

If a single disk fails for any reason, the system detects the 
failure, alerts the system operator and automatically switches to 
use the remaining disk. When the failure is corrected, the 
recovery process is able to proceed in parallel to normal 
operation. 

The operation of mirror disks has impact in the following areas: 

• The MARK ON command informs the operating system of the 
presence of mirror disks with the use of an optional 
parameter. When the disks are marked on, certain criteria 
must be met. The synchronization stamps must agree eind a 
synchronization bit must be set on both disks. If these 
criteria are met, both disks will be marked on and mirroring 
operations will proceed. If these criteria are not met, the 
operator will be advised that synchronization is necessary and 
the Synchronization Utility (DISCSYNC) must be run. 

• The DISPLAY DEVICES command output indicates the presence of 
mirror disks and identifies the primary and secondary disks. 

• The SWOP command allows the primary and secondary disks to be 
exchanged . 

• The DISCSYNC Utility must be run to synchronize disks whenever 
one of the pair has been operating in an unprotected mode. 
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The operational features of the MARK ON, DISPLAY DEVICES and SWOP 
commands, within the mirrored disk environment, are discussed in 
the OS/32 Operator Reference Manual. Refer to the OS/32 
Application Level Reference Manual for general information on 
disk organization and control. The operational features of the 
DISCSYNC Utility are discussed in the remainder of this chapter. 

8.2 OVERVIEW 

The Mirror Disks Synchronization Utility (DISCSYNC) is a support 
component of the mirror disk facility. It copies one disk to 
another so the two disks can operate as a mirrored pair. The 
utility can also be used to verify that two disks are identical 
as a result of the copy operation. While the utility is running, 
all OS/32 application progreims can access data on the disks as 
usual. 

When DISCSYNC has completed successfully, the disks are said to 
be in synchronization. All used parts of the disks are identical 
bit for bit, except for some system data. 

DISCSYNC runs as a stand-alone utility. It is a nonrollable, 
privileged user task (u-task) . 

8.3 FUNCTION 

DISCSYNC copies one disk to another so that the two disks can be 
operated as a pair of mirrored disks. It also verifies that the 
two disks are identical as a result of the copy operation. In 
addition, if synchronization is requested for disks that are 
already synchronized, DISCSYNC does not repeat the 
synchronization. This situation could occur when the operation 
of DISCSYNC is requested from a command substitution system (CSS) 
file. 

The utility can be run in three different situations, although 
the function and operation of the utility are the ssime in each 
case. The utility is used in the following circumstances: 

• To synchronize two empty disks that are being included in a 
system for the first time. 

• To resynchronize two disks that have been operating as a 
mirrored pair after some error has occurred. In this case, 
one of the disks may or may not have been temporarily in 
operation as a single disk while the error situation was 
resolved. 
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• To synchronize two disks when one of them contains valid data 
and the other is a fresh disk. One example of this is when an 
existing system is upgraded to a mirrored system. Another is 
when one disk of a mirrored pair becomes unusable as such and 
must be replaced. 

The use of the utility does not affect the availability of data 
from the good disk in the latter two cases. The utility may 
optionally verify that synchronization is successful after each 
buffer is copied by rereading the buffers from both disks and 
comparing them. Thus, both the read from the source disk and the 
write to the destination disk are verified. 

The utility runs with both disks marked on, whether they were 
marked on together or separately. Both disks must have been 
initialized by the FASTCHEK Utility and given the same volume 
name before being synchronized for the first time. After an 
error situation, the good disk must be checked by the FASTCHEK 
Utility as needed by the marking on operation. Resynchronization 
can run in parallel with OS/32 application programs accessing the 
disk. 

DISCSYNC provides some measure of optimization of the 
synchronization. Large contiguous areas of unused disk space 
will not be copied or verified. 

8-4 OPERATING PROCEDURES 

The following are operating procedures for the DISCSYNC Utility. 

8.4.1 Preliminary Steps 

Before running the DISCSYNC Utility, do the following: 

• Use the FASTCHEK Utility to initialize and record bad sector 
information for both disks. This must be done for all disks 
being mirrored for the first time, or disks that have just 
been reformatted. Otherwise, this step is not necessary. 
Both disks must be initialized with the saime volume name. 

After an error situation where both disks were affected, 
FASTCHEK should be run in checking mode on the primary disk as 
normally required by the MARK ON command for a single disk. 
It is not normally necessary to use FASTCHEK for the secondary 
disk. 

• The two disks supplied must be marked on as a mirrored pair by 
means of one or more MARK ON commands. Mark on the disks as 
a mirrored pair if they are compatible. The MARK ON command 
of mirrored disks fails if the secondary disk has any bad 
sectors present in positions where the primary disk has data. 
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8.4.2 Loading DISCSYNC 

When the Mirror Disk Synchronization Utility (DISCSYNC) is to be 
loaded, use the following procedure. 



I Format: 



LOAD taskname,DISCSYNC Qn^) 
TASK taskneime 



I Parameters: 



taskname 
DISCSYNC 

n 



specifies cuny valid OS/32 task name. 

specifies the nsime of the file containing the 
task. 

specifies the segment size increment. The 
default and minimum value permitted is 16kb. 
To minimize disk seek time and to avoid 
wasting memory, the value of n should be a 
multiple of the disk track size and a factor 
of the cylinder size, but not larger than the 
cylinder size. This is applicable when the 
VERIFY option is not used. When the VERIFY 
option of the START command is used, n should 
be doubled, if possible. See Section 8.4.5 
for a discussion of the effect of the segment 
size increment upon the operation of DISCSYNC. 



\ 8.4.3 Starting DISCSYNC 

! start the DISCSYNC Utility using the START command. 



Format: 



START , DRlVE=dr ive-naime 



,LOG=< 



[log-fd) 



XES^ 



,yERIFY-= 



The parameters of the START command may be input in any order 
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Parameters: 



DRIVE= 



dr ive-najtne specifies the device neime of the 
drive holding the primary disk from which data 
is to be copied. 



LOG= 



log-fd specifies the device neime or file 
descriptor to which messages are to be 
written. The default is CON:, the system 
console. 



VERIFY= 



is an optional paraaneter indicating whether or 
not verification is desired. Verification 
consists of a comparison of the two disks. 
The default is NO. 



Functional Details; 



The utility reads sector from 
synchronization. If the disks 
outputs a message and goes to end of task, 
synchronized, the utility automatically 



both disks and 
are synchronized. 



checks for 
the utility 
If the disks are not 
proceeds to put both 



disks in full mirrored operation. No further operator action is 
required. If the VERIFY option is in effect, verification will 
be performed upon completion of the operation. Upon successful 
completion (end of task 0), the two disks will be marked on and 
in synchronization. 



Examples 



In the following excimple, D300: is the drive containing the 
primary disk. Messages will be sent to the file MIRR.LOG, and 
the two disks will be verified as identical when the mirroring 
operation is completed. 



ST, DR I =1)3 00: ,LOG=MIRR.LOG, VER=Y 



In the following example, D67B: is the drive containing the 
primary disk. Messages will be sent to the printer, and, by 
default, verification will not be performed. 



ST,DRI=D67B: ,LOG=PR: 
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8.4.4 End of Task Codes 

The following is a list of possible end of task codes: 

Successful completion. 

1 Operational error, probably in start 
parcimeters. Rerun correctly. The primary 
disk remains available for applications. 

2 I/O errors or bad sectors on one of the disks 

are preventing synchronization. Reformat or 
replace the disk and then rerun. The primary 
disk will remain available if the error was on 
the secondary disk; otherwise, neither disk 
will be available. 

254 Internal error. A memory dump should be taken 

to allow analysis of the problem. 

8.4-5 Efficient Operation 

The cunount of time required for synchronization is influenced by 
three factors: the size of the disks used as the mirrored pair, 
the amount of I/O activity on the mirrored pair during 
synchronization, and the segment size specified when DISCSYNC is 
loaded . 

The first factor is obvious. A mirrored pair of 256Mb disks 
requires more time to synchronize than a mirrored pair of 64Mb 
disks. 

The amount of I/O activity on the mirrored pair may or may not be 
controllable by the operator. The ideal situation exists when 
DISCSYNC is the only task accessing the mirrored pair. It is 
more likely that other tasks will require concurrent I/O on the 
mirrored pair and, therefore, affect synchronization time. 

The third factor, segment size, allows some degree of 
optimization. When DISCSYNC is loaded, the segment size 
specified by n is used as buffer space for I/O operations. If 
VERIFY = NO is specified, the segment size increment is used as 
one I/O buffer. If VERIFY ^ YES, the segment size increment is 
divided into two buffers of equal size. 

The greatest amount of time used in I/O to a disk is during the 
movement of heads from cylinder to cylinder. By tailoring the 
size of the I/O buffers (via segment size) to the size of the 
cylinders on the mirrored pair, the movement of heads can be 
minimized. 
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If the buffer size specified is a fractional factor of the 
cylinder size (i.e., 1/3), then it will take three read-write 
operations to copy one cylinder. In this case, the I/O will be 
arranged so that the first of every three copies is aligned on a 
cylinder boundary. Thus, there will be no head movement, or 
seeking, between cylinders during a copy operation. If the 
buffer size is not a fractional factor of the cylinder size 
(e.g., 2/3), there will be seeking between cylinders during some 
copy operations. 

It is advisable to be aware of the following when determining the 
segment size to be used when loading DISCSYNC. See Table 8-1 for 
segment size guidelines. 

• To avoid wasted memory, n should be an exact multiple of the 
disk track size and not more than the disk cylinder size. Any 
extra memory designated will be unused. 

• To avoid seek time during I/O transfers, n should be a 
fractional factor (1/2, 1/3, etc.) of the cylinder size. 
This applies only when DISCSYNC is sharing the mirror disk 
pair with other tasks. 

• If the first priority is to complete the operation of DISCSYNC 
as quickly as possible, while DISCSYNC is accessing the disk 
pair concurrently with other tasks, n should be as large as 
memory allows, subject to the two guidelines above. 

• If the first priority is to maintain the performance and 
response time of u-tasks, while DISCSYNC is accessing the disk 
pair concurrently with other tasks, n should be as small as 
possible, subject to the first guideline above. 



The following 
DISCSYNC. 



table provides recommended segment sizes for 



TABLE 8-1 DISCSYNC SEGMENT SIZES 



SEGMENT SIZES (kb) 



67Mb 
256Mb 



ssBssxssssa 



38 



76 



152 



304 
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8 . 5 MESSAGES 

When the utility detects an error situation, it displays an 
explanatory message on the log device and abandons the run. If 
the error is of an operational nature, such as the mistyping of 
a device name, the utility can be rerun. If the error results 
from a problem with one of the disks that prevents them from 
being resynchronized as they are, corrective action should be 
taken before rerunning the utility. If the error is on the 
secondary disk, the primary disk will remain available. If the 
error is on the primary disk, neither disk will be available. 

In the case of I/O errors, the operator is notified that an error 
occurred and that the mirrored pair is no longer synchronized. 
The operator may choose to resynchronize the failing disk or to 
synchronize a different disk. If a different disk is chosen, it 
must have the same name, but may be on a different device. 

The following messages are produced by the DISCSYNC Utility on 
the log device or file. 

Messages : 



ASSIGNMENT ERROR nn ON xx . xx 

indicates that the program attempted to assign logical 
units to their respective file descriptors. The returned 
SVC7 status is nn. The device or filename is xx.xx. 

This message is followed by a subsidiary message which 
can be any one of the following: 



ILLEGAL FUNCTION 

ILLEGAL LU 

VOLUME NOT MOUNTED 

FILE DOES NOT EXIST 

INSUFFICIENT SPACE 

MISMATCH ON PROTECTION KEYS 

ACCESS PRIVILEGES CANNOT BE GRANTED 

INSUFFICIENT OS/32 SYSTEM SPACE 

DEVICE IS OFFLINE 

VOLUME NOT A DIRECT ACCESS DEVICE 

INCORRECT FILE DESCRIPTOR FORMAT 

TRAP GENERATING DEVICE CANNOT BE CONNECTED 

FILE SHOULD BE A PRIVATE FILE 



DISKS ARE ALREADY SYNCHRONIZED 

indicates both disks are already operating as a mirrored 
pair . 
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DRIVE drive -name DOES NOT HOLD A PRIMARY MIRRORED DISK 

indicates that the utility has determined that the drive 
that is supposed to be holding the primary disk is 
actually holding the secondary disk. Primary and 
secondary disks may be changed with the SWOP command. 
(See the OS/32 Operator Reference Manual for instructions 
about the SWOP command ,. ) 



I/O ERROR ON SECONDARY DISK 



INSUFFICIENT MEMORY ALLOCATION SUPPLIED 

indicates there is insufficient memory to set up the I/O 
buffers. Reload with a segment size increment that is at 
least the size of one track on the disk. 



INTERNAL ERROR DSnn 
TASK PAUSED 

indicates that an internal error has been detected by the 
utility. DSnn identifies the crash point within the 
particular code module. Dump the memory areas, pure and 
impure. Then use CONTINUE or CANCEL. If CONTINUE is 
used, the utility stops with end of task code 254. 
Submit a software change request (SCR) to Perkin-Elmer 
with the code DSnn. 



I/O ERROR nn ON dddd 

indicates that an I/O error has occurred on device dddd 
with a status code of nn. Possible qualifying messages 
are: 



ILLEGAL OR UNASSIGNED LU 
PARITY ERROR 
UNRECOVERABLE ERROR 
END OF FILE 
END OF MEDIUM 
DEVICE UNAVAILABLE 
ILLEGAL FUNCTION 



indicates that an I/O error has occurred on the secondary | 
mirrored disk. I 
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If the I/O error is on the log device, then this message 
is followed by: 



MESSAGE DIVERTED TO SYSTEM LOG DEVICE 

and followed in turn by the original message being 
logged. 



MANDATORY DRIVE START PARAMETER MISSING 

indicates the device ncime of the drive holding the 
primary disk has not been specified. 



P-E OS/32 DISK SYNCHRONIZATION 03-978 Rxx-yy 

indicates that the DISCSYNC Utility is operational. The 
prograun's revision level is xx; yy is the update level 
within the revision. This is the identification message 
produced at the start of the utility. 



SYNCHRONIZATION SUCCESSFULLY COMPLETED 

indicates successful synchronization without 
verification, and that both disks are fully operational 
as a mirrored pair. 



SYCHRONIZATION SUCCESSFULLY COMPLETED AND VERIFIED 

indicates successful synchronization and verification; 
both disks are fully operational as a mirrored pair. 



SYNTAX ERROR IN START PARAMETERS 

indicates the parsimeters specified in the start command 
do not correspond to the valid options available. 



VERIFICATION ERROR 

indicates a verification error has been detected 
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APPENDIX A 
CONTENTS OF MAGNETIC TAPE PRODUCED 
BY A STAND-ALONE DUMP 



The following pages are a portion of a sample of a stand-alone 
dump formatted by the OS/32 Dump Print Utility effective for 
release R06 . 2 and higher. 
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CONTENT OF MRRTAPE PPODUCFD Bi A STAND-ALONE DUMP 
CRASH CODE = 102 AT 18:38:33 ON 1/0H/83 



12:57:23 01/07/83 PAGE 1 

PROCESSOR = 8/32 OS32HT06-02 628C.C22 



DUMP OF GEHEBAL PURPOSE REGISTER SETS 



SET F 
RO 00000050 
R1 00000150 
R2 00000017 
R3 000C3«E0 
RU 000006BC 
R5 00000710 
R6 00000000 
R7 00000000 
R8 00000006 
R9 OOOOOOfitt 
RA 000011CC 
RB 00000558 
RC OOOOMOEO 
HD 00000448 
RE 00001670 
RF 000C3FE4 



SET 
00007001 
0001A4BO 
00000000 
00000004 
00000560 
00000000 
00000007 
00002002 
00024756 
000D7060 
3030 2C30 
000FD330 
430080B6 
430060BE 
00007002 
000080B6 



SET 1 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 



SET 2 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 



SET 3 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000 000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000 000 
00000 000 
00000000 
00000000 



SET 4 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
04000000 
00000000 
00000000 
00000000 
00037B8C 



SET 5 
00000009 
000072E0 
0000AF74 
00007330 
0001CACE 
0001C65A 
000072E0 
0000AF74 
0001D0AC 
00OD6788 
00000000 
00000000 
00000000 
0000B700 
00004080 
00000000 



SET 6 
FFFFFB50 
00000001 
00OD6788 
00000000 
000D4D10 
00061058 
00000050 
00OFC5O8 
00027398 
000D69A4 
00000001 
00000000 
0002CCF0 
0000002A 
00007000 
00007062 



DOHP OF HARDWARE FLOATING POINT REGISTERS 



FO 


00000000 


DO 


00000000 


00000000 


F2 


00000000 


D2 


00000000 


00000000 


F4 


00000000 


04 


00000000 


00000000 


F6 


00000000 


D6 


00000000 


00000000 


F8 


00000000 


D8 


00000000 


00000000 


FA 


00000000 


DA 


00000000 


00000000 


FC 


00000000 


DC 


00000000 


00000000 


FE 


00000000 


DF 


00000000 


00000000 



00 

I 
o 



o 

o 

o 



CURRENT TASK 

OT REGISTERS OWNER 

RS REGISTERS OWNER 



D7060 IRDR 
D6788 LEE 
06788 LEE 



00 

I 

o 

H 

o 
o 



o 
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PAGE 



DOHP OF TCB TABLE 



ID 


TCB NAME 


ADDRESS 


TASK FILE NAME 


HID 


GID 


NLU 


START 


END 


SIZE 


SHSZ 


OPTION 


STATUS 


WAIT 


001 


• CSL 


57C8 








000 


001 


12 


16A6U 


16A6« 








00108008 


00000000 


ooooouoo 


002 


.CMDP 


5AA8 








000 


001 


12 


1739H 


1739H 








00108008 


00000000 


ooooouoo 


003 


^MTM 


D9378 


HTM 


:MTMeCC22=TSK/00000 


000 


001 


251* 


mcoo 


59A00 


17E0Q 





02388038 


00000000 


0Q00Q40Q 


OOlt 


•BTHASST 


D7D80 


MTM 


:MTMASST 


.TSK/OOOOO 


003 


003 


1 


59A00 


59C00 


200 





00208028 


00000000 


000001*00 


005 


.SPL 


D7620 


MTH 


: SPOOLER 


.TSK/OOOOO 


000 


001 


15 


59C0O 


5FE00 


6200 





0230082D 


00000000 


00000400 


006 


DATE 


D81U8 


MTM 


:TIME 


.TSK/OOOOO 


000 


002 


15 


5FE00 


60300 


500 





00012021 


00000000 


00000080 


007 


IRDR 


D7060 


MTM 


:IRDR 


.TSK/OOOOO 


000 


002 


1 


60300 


60B00 


800 





0O0O0CB1 


00001000 


00000000 


008 


LEE 


D6788 


HTB 


:EDIT32 


.TSK/OOOOO 


003 


003 


15 


60B00 


63800 


2D00 


7A00 


0C200CA1 


oooouooo 


00010000 


009 


WTM 


D59A0 


MTH 


:CAL32 


.TSK/OOOOO 


003 


003 


15 


6BB00 


8B800 


1FD00 


9C00 


0C200CA1 


00001000 


00000000 


OOA 


LAURIE 


CEiao 


HTM 


:TEXT3 


.TSK/OOOOO 


003 


003 


15 


9B300 


A0500 


5200 


D900 


0C200CA1 


00000000 


00000040 



> 

I 

00 



I 
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PAGE 



SEGMENT CONTROL LIST 



OO 
I 

o 



ADDRESS 


NAME 




START 


END 


SIZE 


USE 


ROLL 


TYPE 


FLGS 


SEEG 


KEY 


ROLL DCB 


SECTOR SSTP PRIV 


FCJAO 


HELPR06 




3A200 


3A600 


400 


2 





SHARED 


C8 




00 






RE 


FCU68 


EDIT32S 




3A60Q 


HICOO 


7600 


2 





SHARED 


C8 


C 


00 






RE 


D9378 


.HTM 




mcoo 


59A00 


17E00 








IMPURE 


48 




00 






RUE 


D7D80 


•MTMASST 




59A00 


59CO0 


200 








IMPURE 


48 




00 






RWF 


D7620 


.SPL 




59C00 


5FE00 


6200 








IMPURE 


48 




00 






RWE 


D81l»8 


DATE 




5FE00 


60300 


500 








IMPURE 


48 




00 






RHE 


D7060 


IRDR 




60300 


60B00 


800 








IMPURE 


48 




00 


FF007740 


A48 


RWF 


D6788 


LEE 




60B00 


63800 


2D00 








IMPURE 


48 




00 


FF007740 


2210 


RWE 


**FBEE** 






63800 


6BB00 


8300 




















D59A0 


MTH 




6BB00 


8B800 


1FD00 








IMPURE 


48 




00 


FF007740 


4C0B 


RWE 


FD390 


MTM CAL32 


TSK 


8B800 


95400 


9C00 


1 





PURE 


49 


5 


00 


FF007740 


53B8 


RF 


FCC88 


MTM TEXT3 


TSK 


95400 


9B300 


5F00 


1 





PURE 


49 


D 


00 


FF007740 


4AB7 


R'i' 


CE1i»0 


LAURIE 




9B300 


A0500 


5200 








IMPURE 


48 




00 


FF007740 


4748 


RWE 


••FREE** 






A0500 


B5000 


14800 





















o 

o 

50 
o 

M 



00 

I 
o 

(X) 

<% 
O 
O 



o 
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PAGE 



DCB 


FCB 


SIZE 


FILENAME 




TYPE 


WCNT 


RCNT 


FIGS 


69C0 


FCEA8 


490 


H300:a0426991 


.001/00016 


IN 


FFFF 


1 


COOOOOOO 


69C0 


C71A0 


C90 


M300:OS3230 


.0BJ/00010 


IN 





4646 


84589040 


69C0 


D61F0 


02020 


H3OO:SLIB3220 


1. OBJ/00125 


IN 


9529 


0036 


6555045 


69C0 


EB2C8 


128 


M300:SYSTEM 


•DIR/OOOOO 


CO 


FFFF 


FFFF 


40400000 


6E50 


D11F0 


2090 


«301:MTHBAIN 


.CAL/00096 


IH 





1 


COOOOOOO 


6E50 


DA860 


128 


M301:SYSTEM 


.DIR/OOOOO 


CO 


FFFF 


FFFF 


40400000 


72E0 


D4D10 


C90 


«fi7A:£042711C 


1.001/00082 


IN 


FFFF 


1 


C4400000 


72E0 


CEA40 


490 


H67A:G 


.CSS/00096 


IN 





1 


COOOOOOO 


72E0 


CEEDO 


1690 


B67A:HTMHAIN 


.LST/00096 


IH 


FFFF 


2 


C4000000 


72E0 


D0560 


C90 


M67»:HTBKAIH 


.OBJ/00096 


IH 


FFFF 


1 


E1000000 


72E0 


D3280 


C90 


M67A:MTB 


.CSS/00096 


IN 





1 


COOOOOOO 


72E0 


D5D60 


490 


M67A:BTM 


.LOG/00096 


IH 


1 





C4400000 


72E0 


D6B48 


490 


B67A:BTB 


.JOB/00096 


IH 


FFFF 


FFFF 


COOOOOOO 


72E0 


F8630 


128 


M67A;SYSTE» 


.DIR/OOOOO 


CO 


FFFF 


FFFF 


40400000 


7740 


FC6A8 


490 


HTM :SPL 


.QUE/00000 


IN 


FFFF 


1 


C4400000 


7740 


FC220 


128 


MTB :PAGE 


/00255 


CO 


FFFF 


FFFF 


40400000 


7740 


DA3D0 


490 


BTB :BATFIL 


/00255 


IH 


FFFF 


FFFF 


C4400000 


7740 


DSeES 


C90 


BTB :AUFILE 


/00255 


IH 


1 


1 


EC400000 


7740 


FCB38 


128 


BTM :EBKOR 


.LOG/00000 


CO 


1 


1 


40400000 


7740 


FD990 


128 


BTB :SySTEH 


.DIR/OOOOO 


CO 


FFFF 


FFFF 


40400000 


7F40 


FBD98 


128 


FIXD:SYSTEK 


.DIR/OOOOO 


CO 


FFFF 


FFFF 


40400000 



I 

01 



COHTEKT OF BAGTUPE PRODUCED 
JOURNAL DUHP 



BT A STAND-ALOHE DUMP 
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PAGE 



TASKID 



001 
001 
001 
00) 
00) 
003 
003 

oot 

00 > 
001 
001 
00) 

ooa 

001 
00* 
001 
003 
003 
00) 
00 3 
00( 

00 e 

00( 
001 
00* 
001 

ooa 
oot 

001 
001 

ooa 
ooa 
ooa 

009 

ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 

001 
OOi 

ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 

005 
005 
005 
005 
005 
005 
005 
005 
005 
005 
005 
005 
00 S 

ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 
ooa 

00* 
00* 
00* 
00* 
00* 
00* 

ooa 
ooa 

007 



HODULENAHE 



SVCI 
SOS 

thkoisf 
s»ci 

THRDISP 

S»C9 

THUCHI 

TDiOISP 

S»C2 

Taasii 
TatDisr 

S»C2 

Timsii 

SOS 

TaiEiv 

TUCK) 
SOS 

Tuaoisp 
s»ca 
TaucHa 
Taao.sis 

TKIDISP 
S«C2 

Tiia<:i> 

raioisp 

s»ci 

TiastiB 

eigcai 

s»ci 

TaUCHI 

SOS 

THIDISP 

SOS 

TalDISP 

S»C1 

Taasti* 

EVOCOB 

ETOIS 

TKROISP 

SOS 

TBREBB 

TBCHB 

THiD.SIS 

S«C1 

TBUCHB 

SOS 

TBBDISP 

S»C1 

TUBSklB 

EIOCOB 

Eirois 

TIIBDI<iP 

S»C1 

TKBStlB 

EfOCOi 

EYDIS 

TBBDISP 

SOS 

ToaEBK 

TBCHB 

TBBDISP 

S»C2 

TBBSOUT 

S»C1 

TBBStlB 

E>gC3B 

E<DIS 

TBBDISP 

S»C1 

SOS 

TBBDISP 

s»ca 

TBUCHB 

TBBDISP 

S»C» 

TBBStIB 

EfOCOB 

SOS 

TBBD.SIS 

E«DIS 

TBBDISP 

SOS 

TBBDISP 

$>C1 

TBBSklB 

E'OCOB 

E'DIS 

TBBDISP 

SOS 

TBBEBII 

TICNB 

TBBD.SIS 

tVDIS 

TBBDISP 

S»C7 

TBBSIB 

TBUCHB 

TBBEBB 

TBCKB 

IIH 



REGISTEF.C 

OOOiDCfC 

oooiretc 

000Da5«>l 
0005 31ISC 
000D9!><m 
00000000 
C*015E30 
OaODt95« 
O0OCO650 
OOOniOFO 

oooDta^n 

000005)11 

ooooioro 

000IC6tC 

ooooooot 

00000006 
0001C«tC 

oooDa5«« 
oooooooo 

C*015E)0 
000D6a«« 

aooDta5ii 

O0OOC50C 
00007010 
000Dta5< 

oooooaat 

OOOrDBBS 
B00}5Br] 
OO0D»E1« 
0000<i7C 
OOOICtBC 
OOODSBtC 

oooicenc 

OOODSBiC 

0000017* 
ooorcDto 

•0025BF3 
00025F7C 
OOOD5B6C 
OOOICttC 
OOOOOOFF 

000000 rr 
ooorDif* 

000DIIE7C 
0000«B7C 

oooicetc 

000D5BeC 
0000017* 
OOOrCDBO 

aoo}5ar3 

000]5r7C 
OOOOSBtC 
0000017* 
OOOrCDBO 
B0035Br2 
00025r7C 
000D5BeC 

oooicttc 
oooooooe 

00000006 
000D77EC 
0000)59* 
000D77fc 
OOOOtuP* 

oooroaoa 
aoo25(r3 

00025F7C 
000D77FC 
0000*«B« 

oooicoc 

O0OD77EC 

ooorD«Fa 

DE0016D0 
D00D5B6C 
0000017* 
OOOrCDBO 
•0025PF2 
000IC6>C 
OOOFCDBO 
00025F7C 
000D5I6C 
0001C6BC 
000D5B6C 
D000017* 
OOOFCDBO 

aoaiSBE} 

00025r7C 
000D5B6C 
0001C6BC 

oocDoorr 

OOOOOOFF 
000FD*6a 
000D*E1* 
0000*95* 
000rD6 70 
OO0FD670 
000D69** 
000D*65* 
OO0DB6 5B 

*)oo*ope 



REGISTER. D 

O00«3C6C 

oooooooo 

00001000 
0005 )*5C 
00001000 
00O*23t>l 
00001000 
0000 10O0 
000]ltC50 
0003tC50 
00001000 
0006103* 
0006103* 
OOOOOOOO 
00000*00 
00000*00 

oooooooo 

OOOOIOOO 
O0O«23t* 
OOOOIOOO 
OOOOOOOO 
OOOOIOOO 

oiioatooc 

00061000 
OOOOIOOO 
00061)** 
00006*70 
000D6B7C 
000D*E1* 

ooooaooo 
oooooooo 

OOOOIOOO 

oooooooo 

OOOOIOOO 
0006BC7* 
000D5t9* 
000D5»9* 
313536)6 
OOOOIOOO 

ooooaooo 
ooooaooo 
ooooaooo 
oooooooo 

OaOD*E7C 

ooooaooo 

OOOOOOOO 
OOOOIOOO 
0006 BC7* 
000D5>9* 
000D5>9* 
3135)637 
OOOOIOOO 
00068C7* 
000D5I9* 
0000519* 
31)5)6 36 

OOOOIOOO 

OOOOOOOO 
00000*00 
00000*00 
OOOOIOOO 
0005D19* 
OOOOIOOO 

ooosroB* 

000D771* 
000D771* 
00000020 
OOOOIOOO 
0a05EOBa 

oooooooo 

OOOOIOOO 
0005D*Oa 
OOOOIOOO 
OOOOIOOO 
PO06BC7* 
0000569* 
0000569* 
OOOOOOOO 
OOOOOOOO 
3135)6)9 
OOOOIOOO 
OOOOOOOO 
OOOOIOOO 
0006BC7* 

oooDSta* 
oooDSta* 

31353730 
OOOOIOOO 

oooooooo 
ooooaooo 
ooooaooo 
oooooooo 

20203020 
OOOOIOOO 
0006105* 
00061056 

oooooooo 

00000*00 
00000*00 
*300*0BE 



REGISTER. E REGISTER. F 



000072r0 
000D9)7I 

oooo72ro 
oooo72ro 

00OO7 2f 
00OO7 2F* 
000072FO 

oooo77ro 

OO0O77F2 
00007 7F 2 

oooo77ro 

000077F2 
OOO077r2 
000D676B 
000D67*a 
000067*6 
O00OB3E> 
000072rO 
OOa072F* 
00007 2ro 
00007 260 

oooo77ro 

000077F2 
0OO077F3 

oooo77r6 
oooo77ro 

000D6D10 
0000*010 
00007 360 
0000*060 
0000671* 
OOO077F2 

oooDsato 

00007 7F0 
000077F0 

oooDiiro 

OO0D1IFO 
000D17Ea 

aooo77ro 
oooDsato 

OOOOOOEC 
OOOOOOEC 
00007 360 
00007260 

oooonoto 

000067*6 
000077FO 

oooo77ro 
oooDiiro 
00001 iro 

000D1*)* 
OO0077F0 
000077rO 

oooDiiro 
oooDiiro 

OOODI*** 
000077r0 

oooDsato 

000D5960 
000D59«0 
000077FO 
OOO077r9 
0O0077r9 
OOO077r0 
OOOFCEt* 

ooorcEi* 

a00FD2r3 
00007 7F0 
OO0077F0 
OO0D762O 
eOO077F0 

00007 7ri 

000077r0 
00007 7r2 
000077F0 
000D11F0 
OOODI 1F0 
00005 96 
00007 26 2 
OOODIBD* 

00007 7ro 

00005960 
000077P0 

oooo7Tro 
OOODI iro 
OOODI iro 

000DI92* 

oooo77ro 

00005*60 
OOOOOOEC 
OOOOOOFC 
00007 260 
OOODtPE* 

oooo77ro 

000077F2 
000077F2 
00DD6 76* 
000rD)30 
OOOFD330 
00007002 



000li)t6t 
OOOOBJE* 
000<l)i:66 
OOOxlEOO 
0OOV3E00 
OOOi43DliO 
000«2P*0 
OOOC*0*0 
OOOCOVEt 

aooco*ri 

OOOCO'Fl 
0000 051* 
0OOC05 1" 

ooooBjru 
*ooicr6o 
*ooicr60 

OOO0B2E* 
000U2CE2 
000*3D*0 
000*20*0 
000207B* 
0000051* 
000C3526 
00003526 
0000 3526 
OOOOIOWO 

aaorDa20 

OOOD*D0* 
000263EC 
000067*6 
0000«F7* 
O0O5IS51E 
0000»r7* 
000561*3 
00051306 
OO0FCD66 
0000126* 
0000136* 
00051206 
OOO06F7* 
0000*060 
0000*060 
00036 3EC 
00026*91 
OOOOOOOO 
0000AF7* 
0005516* 
0005 1306 
OOOFCD** 
0000126* 
0000126* 
00051306 
00051206 

oooroD6* 

0O0D126* 
OO0D126* 
000>1306 
0000B2]* 
*00icr60 

oooioreo 

000000*6 
OOOOODt 
OOOOOOt 

0000 1 me 
ooorOBOo 

0O0FCF5C 

ooorcr«c 

00001106 
00001216 
0000*2)* 
0000121* 

ooooocaa 

00000C96 
0OO565*E 
00051306 

ooarcD6a 

OOOD126* 
0000*2)* 
OO03B036 
0000136* 
00051206 
a0006F7* 
000519** 
00051206 

oaoFCD6a 

OO0DI26* 
000DI3** 
00051306 
00006F7* 
0000*0*0 
000000*0 
00026*9* 
OOOD*DC« 
0000*0*0 
OOOOFF* 
OOOOFF* 

ooocsrr* 

0003B9** 
OO03B9** 
0000*0*6 



A-6 
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12:57:23 01/07/83 



PAGE 



12 



002CAO: 
OO2CC0: 
002CE0: 
OO2DO0: 
002D20: 
002D40: 
002D60! 

002DA0: 
002DC0: 
002DEO: 
OO2E00: 
002E20: 
002EttO: 
002E60: 
002E80: 
O02EA0: 
002EC0: 
002EE0S 
002F00: 
002F20: 
002FttO: 
002F60? 
002F80: 
002FA0: 
002FC0: 
002FE0: 
003000: 



caeoooio 

24644300 
246823aA 
00000237 
82A658C9 
4002OFE0 
41804002 

FFD841C0 
4001A57A 
118E42A0 
40021BEA 
08CD08DA 
4002CDB4 
41804002 
4001A3C8 
03ADE6BA 
56C841B0 
80E6E6BA 
19525890 
00074180 
588901C8 
40022EEO 
4002118E 
42304001 
000050D9 
43304001 
4001A57A 



4300804E 

80302462 

24692308 

E2000000 

005C4230 

00614300 

109A4280 

00624300 

81F64180 

08DA4180 

4001A57A 

41C081C0 

41804002 

41804002 

118E42A0 

23362682 

001B4180 

40024F34 

00074180 

400056AC 

4002118E 

50C80004 

# 100603^ 

42A04001 

A47C5890 

01A4030C 

A5C45889 

E2000000 



24674300 

4300802A 

246A2306 

05010000 

8022E6BA 

4001BB44 

4001A57A 

400200F4 

40020FE0 

40020FE0 

08DA4180 

58C90068 

0FE00066 

CDEC4300 

4001A57A 

C5800018 

4002118E 

43004002 

4002118E 

433080F8 

42A04001 

73C90080 

!{1804002 

A57A08CD 

400056AC 

C3F00001 

01C8D0E8 

01314300 



80482466 
24614300 
246B2304 
00000000 
00134180 
41804002 
D38A0001 
41S04002 
00634300 
00644300 
40020FEO 
4230802E 
58A04000 
FFC241C0 
D38A0000 
20872309 
42A04001 
72144180 
42804001 
5899026C 
A57A08CD 
E6CC4900 

A E» Oft n rt ^ c 

08DA4180 
43308054 
42304001 
000050D9 
4001AC60 



43008042 
80242460 
246C2302 
41C08288 
4002118E 
CDB44180 
27872134 
CDB44180 
40021334 
40021A1E 
006558A0 
E6BA002F 
56C841B0 
817658C9 
C58000FF 
D3B84001 
A57A08DA 
4002CDB4 
A57A08DA 
21334300 
08DA4180 
00000899 
43004 002 
40020FE0 
C3E00200 
A47C5890 
01A408AD 
00000000 



24654300 

4300801E 

246D0876 

43004001 

42A04001 

4002CDEC 

58C90060 

4002CDEC 

41C08210 

41C081F0 

400056C8 

41804002 

40024F34 

006C4230 

42308028 

A3C908AD 

41804002 

41804002 

41804002 

FDFA08DF 

40020FE0 

08CC08AA 

1 9FA4 ICO 

006F4300 

43304001 

400056AC 

C3D00003 

00000000 



803C2464 
246F230E 
11725A74 
A5B2C4E0 
A57A08CD 
4300FFCE 
213A08CD 
41804002 
41804002 
E6BA000B 
41B04002 
118E42A0 
43004002 
8074E6BA 
078848BA 
E6BA4B00 
0FE00067 
CDEC4300 
OFE00069 
27D641C0 
006A58A0 
41B04002 
804EE6BA 
4003054C 
A5C45889 
43308028 
033C50A9 
43004001 



43008036 
246E230C 
001C5877 
FFFO41C0 
08DA4180 
41C08268 
08DA4180 
109A4300 
109A42A0 
41804002 
4F344300 
4001A57A 
1EA04180 
000308DA 
OO0OD4B8 
00002304 
58A04000 
FF7C41C0 
43004002 
SOAAEeBA 
400056C8 
4F144300 
000E4180 
C3F00001 
01C8D0E8 
C3E00200 
01AC4300 
B91E0000 
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APPENDIX B I 

CONTENTS OF MEMORY PRODUCED BY A PANIC DUMP I 



The following pages contain fragments of a seimple display from 
the Dump Print Utility for release R07.2 and higher. It is from 
a Model 3200MPS System. 



48-031 FOO R02 



B-1 



to 

I 

to 



CONTENTS OF MEMORY PRODUCED BY A PANIC DUMP 

CRASH CODE = *NONE* AT 11:29:47 ON S/15/83 



15:33:27 08/22/83 
PROCESSOR = 3200 OS32MT07-01 



PASE 1 
BJO.HPS 



DUMP OF GENERAL PURPOSE REGISTER SETS 



SET F 

RO 00000000 

R1 0000S682 

R2 00000000 

R3 0001A0B2 

R4 00000000 

R5 00100000 

R6 0001BC92 

R7 00000000 

Re 00018E38 

R9 00000001 

RA 00000000 

RB 00019S0A 

RC 00000000 

RO 0000001F 

RE 000133E6 

RF 0001A3F3 



SET 
C0047200 
00000070 
00000010 
00000008 
00000400 
00000000 
00000006 
001F3FE0 
00027CH8 
00000000 
00000000 
00000000 
00009160 
0002859A 
00002B60 
00027854 



SET 1 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 

oocooooo 

00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 



SET 2 

00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 

oocooooo 

00000000 



SET 3 

00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 

oocooooo 

00000000 
00000000 

oocooooo 
oocooooo 

00000000 

oocooooo 
oocooooo 

00000000 



SET 4 

oocooooo 

00000000 
00000000 
00000000 

oocooooo 
oocooooo 
oocooooo 
oocooooo 
coococco 

00000000 

ooocococ 

00000000 

oocooooo 
oocooooo 
oocooooo 
oooocooc 



SET 5 
0O0000C6 
FFFFFFFF 
CODOOCOO 

oocooooo 

0001F324 
00000400 
000420SA 
00047052 
C001F204 
00027eE8 

ocooooco 

00C0072B 

oocooooo 

00008484 
00C4F200 
00007FD8 



SET 6 
00000009 
00002DDC 
00002360 
0002C874 
COOOOFFF 
00019F14 
OOOOCOOC 
OOOOCOOO 
C002828C 
00002B60 
00000000 

oocooooo 

C0002E40 
00000000 
C00472F0 
00000010 



FO OOOOCOOC 

F2 OOOOCOOC 

F4 OOOCOCOC 

F6 OOOOCOOO 

F8 OOCOOOOO 

FA OOOOCOOO 

FC OCOOOOCO 

FS OOCOOOOO 



DUHP OF HARDWARE FLOATING POINT REGISTERS 

00 OOOOCOOO 00000000 

02 OOCOOOOO 00000000 

04 OCOOOOCO 00000000 

06 00000000 OCOOOOCO 

D8 OOCOOOOO OOCOOOOO 

DA OOCOOOOO OOOOCOOO 

OC OOCOOOOO OOCOOOOO 

DE 00000000 OOOOCOOO 



00 

I 
o 

CO 
M 

'n 
o 
o 

» 
o 



CURRENT TASK 

UT REGISTERS OUNER 

RS REGISTERS OUNER 



2860 



**NONE** 
• CHOP 
**NONE** 



00 
I 
O 



CONTENTS OF MEMORY PRODUCcD 2* A PANIC DUMP 



15:33:27 C8/22/83 
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DUMP OF AP3 TA3LE 



o 
o 

jd 
o 



ID 


AOOR 


STATUS 


CTCB 


CONTROL STATE 


WAIT TCB 


CONTROL TCB 


QUEUE 


PASSBACK 


1 


84F0 


UOQO 


00000000 


DISABLED 


NONE 


NONE 


1 


00000000 








»jK<k<k<«.nAA 


^■#^ani r- m. 


K.Mb. c 


k.if\b.,C 


1 


rinnnnnnn 


2 


b910 


0000 


uuuuuuuu 


Ul^HCL CU 


n\fnc 


nun t. 


fc 


www www 


3 


8D30 


0000 


00000000 


DISABLED 


NONE 


NONE 


3 


00000000 



DUMP OF THE QPBS 



ID 


AOOR 


NO. 


TASKS 


READY QUEUE 


STATE 


EXCLUSIVE TASK 


MAPPING TASK 





9160 







00000000 


ON 


NONE 


NONE 


1 


9180 




2 


001F3480 


ON 


NONE 


NONE 


2 


91A0 







00000000 


OFF 


NONE 


NONE 


3 


91C0 







00000000 


OFF 


NONE 


NONE 



03 
I 
CO 



C3 CONTENTS OF McMOfr f-CjObCtD 3Y A P4MC DUMP 15:33:?7 C8/i:2/83 PAGE 

I 

DUMP OF TCB TABLE 



ID 


TCa NAME 


ADDRESS 


TASK FILE 


NAME 


MID 


SIO 


NLU 


START 


END 


SIZE 


SHSZ 


OPTION 


STATUS 


UAIT 


001 


.CSL 


2730 






000 


001 


13 


181B4 


18184 








32108008 


00000000 


00000400 


002 


• CHOP 


2aao 






000 


001 


13 


18D04 


1SD04 








32108008 


00000000 


00000400 


003 


B1 


1F34B0 


HTM IBACKUP 


.TSK/00000 


000 


002 


8 


3E000 


43000 


5000 


5100 


OOiOOC2C 


08000000 


00000000 


004 


B2 


1F2FE0 


MTH :BACKUP 


.TSK/00000 


000 


002 


8 


43CO0 


48000 


5000 


5100 


00200C2C 


08000000 


00000000 



00 

I 
o 

(a) 



•7} 
o 
o 

o 



•1^ CONTENTS OF '(EMORY PRODUCED BY A PANIC DUMP 15:33:27 08/22/83 PAGE 

00 

I 

2 SEGMENT CONTROL LIST 

^ ADDRESS NAME START END SIZE USE ROLL TYPE FLGS SREG KEY ROLL DCB SECTOR SSTP PRIV 

•^ 1F33B0 MTM BACKUP TSK 38800 3D900 5100 2 PURE 48 9 00 300 RE 

g **FREE** 

1F34BC 31 



O ♦•FREE** 

ro 



START 


END 


SIZE 


USE 


ROLL 


TYPE 


FLGS 


SREG 


KEY 


ROLL DCB 


38800 


3D900 


5100 


2 





PURE 


48 


9 


00 




3D900 


3E000 


700 
















3E000 


43000 


5000 








IMPURE 


48 




00 




/ T ft n n 


/. o A n n 


cnnn 


n 


n 


T y p n p r 


4S 




00 




^ J uuw 


^ V\J\J\J 


^ v. V 


w 














48000 


1C2000 


17A000 

















RUE 
RUE 



00 

I 

IP 



I 



CCNTEnTS of IEMOPY Pf.CObCcD ?.» 4 PiMC DUMP 



OUMP OF SrSTE"^ OATA STRUCTURES 



15:33:27 08/22/83 



PAGE 



00 

I 

o 

CO 



O 
O 

o 

to 



SPT 002540 
SPT.INIT 43004001 DF6C 
SPT.CRSH 0000 
SPT.FLV 00007ESO 
SPT.LLV 00008354 
SPT.HLBL 0064 
SPT.CTSP 0004 
SPT.CSLV 00000006 
SPT.CSBF O0O0QO66 
SPT.CHBK 0080 
SPT.ISPT 0300 
SPT.CTOP 00038168 
SPT.UTOP 001C2000 
SPT.UBOT 00038800 
SPT.PilEH 001F400Q 
SPT.MTOP 001F4000 
SPT.OSIO 4F533332 40543037 
SPT.IVT 0000845C 
SPT.TTAB D00026EC 
SPT.MTM 00 
SPT.NTCB 23 
SPT. 60 003C 
SPT.OMT a0005AB0 
SPT.VMT 00007E90 
SPT.SVOL 4D544DZD 
SPT.SPVL 20202020 
SPT.RVOL 40S44D20 
SPT.TVOL 4D544020 
SPT. SHOD 00000000 
SPT.JRNL 00002F3C 
SPT.FREQ 0076 
SPT. PIC 006C 
SPT.LFC 0060 
SPT. CPU 0C80 
SPT.SOPT 9776F200 
SPT.VERN 424A442E 40505320 
SPT.CLSS 0004 

0000 
SPT.SSTE 0400 
SPT.SSTS 0020 
SPT.AOCK 0002452C 
SPT.A0K1 00024538 

00000000 00000000 00000000 00000000 
SPT. DATE 
SPT.MNTH 0008 
SPT. DAY OOOF 
SPT. YEAR 0053 
SPT.TSL 0000 
SPT. TIME OOOOAIAB 
SPT.DTHD 00005B50 
SPT.TQHO 00000000 
SPT.IOHD OO1F3FE0 
SPT.RTLS 00000000 
SPT.TCMS OOCOOOOO 
SPT.SCTM 00030000 



*C.£ . • X 



*..s. 
*..a. 

♦0S32MT07 

♦ ...\ 
*..t. 
*. 

*MTH 

»HTM 
*MTM 

* • • • • 

*.x 
*.l 



•BJO.HPS 



.E8 



..CP 
..T 



00 

I 

o 

w 

>^ 
o 
o 

o 



00022',C2 

00000000 00000000 00000000 00000000 00000000 



CONTENTS OF MtMORT PRODUCED 3Y A PANIC DUMP 

SPT.SCTT OOCOOOOO 

SPT.OSUP 2D303120 

SPT.PANC 00031504 

SPT.PSV 00047062 

SPT.RSV OOIFJFEO 

SPT.TSV 00000000 

SPT.AFSV 00000000 

SPT.SCL 001FJ3B0 

SPT.FLST 00048000 

SFT.rSir uu1r3S50 

00000000 
SPT.RINQ 000278E4 
SPT.ROCB OOOCOOOO 
SPT.SPCT 0000 

0000 
SPT.EDNA 00000000 
SPT.EMHO 00000000 
SPT.EMTL 00000000 
SPT.CTCB 00000000 
SPT.UTOW 00002E40 
SPT.RSOU 00000000 
SPT.ESOM 00000000 
SPT.MCOM 00000000 
SPT.EFOM 00000000 
SPT.OFOM 00000000 
SPT.RSON 00047260 
Spi.RSOF 00047060 
SPT.RLIO 00000000 

00000000 
SPT.VALU 00000001 
SPT.HLOA OOOCOOOO 
SPT.HLOB 00000000 
SPT.PAGE 00000800 
SPT.SCLP OOOOOOOS 
SPT.ADOH OOFFFFFF 
SPT.OFFM 000007FF 
SPT.PAGM 0000F800 
SPT.SEGH OOFFOOOO 
SPT.CPID 00000000 
SPT.CPIE 00124096 
SPT.HISS 00000000 
SPT.NODE 20202020 

20202020 
SPT.PSDO 00000000 
SPT.PSOT 00000000 
SPT.QM OOOCOOOO 
SPT.TID 00000002 
SPT.PID 0000 
SPT.IPID 0000 
SPT.ER8L 00005A98 
SPT.ROrO 000273DC 

00000000 
SPT.LPMT 00009210 
SPT.flPBO 00009160 

00000000 00000000 00002780 00002B60 
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« a 


• • 


• 


*• 
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CD 
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00 
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PAGE 



00 

I 

o 

M 

O 
O 

1=0 

o 



TCB 


002780 




TCB.FPTR 


00002780 




TCB.BPTR 


00002780 




TCB.BPTR 


00000000 




TCB.CTX 


00002A60 




TCB.FLGS 


00000000 




TCB.RTCV 


00000000 




TCe.ET* 


OOOOOOOO 00000000 




TCB.TPTR 


00000000 




TCB.PBLK 






TCB.PRC* 


OOOOOOOO 




TCB.PRCB 


OOOOOOOO 




TCB.PRCC 


OOOOOOOO 




TCB.PRCO 


OOOOOOOO 




TCB.PRCE 


OOOOOOOO 




TCB.PRCF 


OOOOOOOO 




SOE.FPTR 


OOOOOOOO 




S0E.6PTR 


OOOOOOOO 




SOE.NANE 


2E43534C 20202020 OOOOOOOO OOOOOOOO OOOOOOOO 


SOE.SAOR 


00018184 




SOE.SIZe 


OOOOOOOO 




SOE.USE 


0000 




SOE.ROLL 


0000 




SDE.FLGS 


00 




SOE.TYPE 


00 




SOE.SREC 






SOE.PREG 


00 




SOE.KEr 


00 




SOE.«SG 


OOOOOOOO 




SOE.FSEC 


OOOOOOOO 




SOE.SSTP 


0000 




SaE.PRIV 


00 
00 




TCB. no 


01000000 




TCB. STAT 


OOOOOOOO 




ICS.EQ 


OOOOOOOO 




ICB.PQ 


OOOOOOOO 




IC8.PSU 


OOOOOOOO OOOOOOOO 




ICB.FLIH 


OOOOOOOO 




ICB.IPCB 


OOOOOOOO 




ICB.LINK 


OOOOOOOO 




tCB.HEAO 


OOOOOOOO 




ICB.1CL 


OOOOOOOO 




ICB.27CL 


OOOOOOOO 




ICB.3CL 


OOOOOOOO 




ICB.6CL 


OOOOOOOO 




ICB,7CL 


OOOOOOOO 




ICB.6RX 


OOOOOOOO 




ICB.RCNT 


0000 




ICB.FLGS 


0000 





«... 



*.CSL 



*. 






TCB. WAIT 00000400 
TCB. OPT 32108008 



*2.. 



00 

I 
o 

H 

o 
o 

% 
o 

to 



CONTENTS CF MfMORV PPCOUCEE 3* ft P4MC DUMP 



15:33:27 08/22/83 



PAGE 



TC3.CLC 
TCB.T&O 

TCB.VOFF OCOO 

TCB.RSV 0000 

TCB.RSAC 0000 

TCB.RCNT 0000 

TCB.PRI 01 

TCB.RPRI 01 

TCB.DPRI 01 



oocoooou 

03000000 



ikQ»rirnA ui 



TCB.CTSW 

TCB.SLOC 

TC3.CT0P 

TCB.UTOP 

TCB.TTOP 

TCB.OBOT 

TCB.OCB 

TCB.TEQH 

TCB.SES 

TC6.LR* 

TCB.PSTD 

TC6.SSTD 

TCB.4DCK 

TCB.MXSP 

TCB.USSP 

TCS.SYSP 



TCB.NSHO 

TCB.HSEG 

TCB.SOPT 

TCB.OtAY 

TCB.VOL 

TCB.SVAD 

TCB.TMP1 

TCB.USER 

TCB.SrS 

TCB.SYS1 

TCB.SYS2 

TCB.SYS3 

TC8.SYS4 

TCB.SYS5 

TCB.FD 

TCB.VOLN 

TCB.Fh 

TCB.EXT 

TCB.DATE 

TCB.ACCT 

TCB.RC 

TCB.USRA 

TCe.UACT 

TCB.GACT 

TC8.m:D 

TCB.GID 



C8004hC0 
00000000 
00000000 
00000000 
00000000 
00000000 
OOOOOQOO 
00000000 
00000000 

00000000 
00000000 
00000000 
FFFFFFFF 
00000000 
00000000 

uuuOuuuu 

00 

00 

0000 

00000000 

00000000 

00000000 

0001S224 

00000000 

00000000 00000000 

00000000 00000000 

00018308 

00000000 

00000000 

00000000 

00000000 

00000000 

00000000 

OOOOQOOQ 00000000 

00000000 

00000000 

0000 

0000 

00000000 oooooooo 

0000 

0000 

00 

01 

0000 



tX) 

I 



a 
I 



CONTENTS OF M£»(ORr PB0auCE3 BY A PSMC OUMp 

TCB.CPL« OOOCGOOO 

TCB.CPU 30000SA8 ODOOOQFB OCGOOCOO ncOOOOOO 

TCB.ACUM 

TCB.WTI'* 00143809 

TCB.RTIM 00000000 

TCB.HOLD 

TCB.TMWT 0OU4BF0 

TCB.ROUT 00000000 

TCB.STIH 00000000 



15:3^:27 08/22/B3 
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TCB.TSL 


0000 


TCB.RLSL 


0000 


TC9.TI1R 


0000 


TCB.LOAD 


00 




00 


TCB.XFRS 


00000000 


TCB.IOC 


0001 


TCB.IOAC 


0000 


TCB.IOBL 


0000293C 


TCB.C:OB 


OOOOSBAO 


lOB.NXT 


03000000 


I0B.RFL6 


0000 


106. PRI 


01 


lOB.TYPE 


01 


lOB.OONE 


00000000 


I0B.DC8 


Q0005B50 


lOfl.TCB 


00002780 


lOB.ESR 


00009320 


I0B.UP8K 


00018480 


lOB.PBLK 


00018480 


I06.FC 


41 


lOB.LU 


oo 


lOB.STAT 


00 



*.. 






*..CP 



•A 



lOB.ODPS 00 

lOB.SAOR 0OOOS679 

lOB.EAOR 0O0OS6DC 

I06.RAN0 00000000 

lOB.LUE EB005B50 

I0B.SV1X 20000000 

lOB.WCHN 00000000 

lOB.CYL 0000 

rOB.SECT 00 

lOB.LSEC 00 

TC8.UCTX 00002A60 



..Vy 

,.v. 

!!cp 



00 

I 
o 

M 

o 
o 

Jd 
o 



CTX.FPTR 00000000 
CTX.BPTR 00002A60 
CTX.TCB 00002780 
CTX.TRCE 00018306 
CTX.PSW 00047062 0002595E 
CTX.PSTO 00000000 

CTX.REGS 00000000 00000000 COCOOOOO 00000000 00000000 00000000 00000000 00000000 
00000000 00000000 OOCOOOGO 00000000 OOOCOOOO 00000000 00000000 00000000 



TCB.LPU 00 



■ pb. 



00 

I 
o 



O 
O 
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CONTENTS OF "E'lORr PRODUCED 5Y A PANIC DUMP 
TCB.CUE 03 
00 
TCB.NLU 00 
TCB.UCON 00000000 
TCB.LTFL 00002A20 
TCB.FMtU 00000000 
TCe.LTAB E8005BSO 
TCB.TUB 00000000 
TCB.AF 00090000 

IVOaAJ. UUUUUUUV 

TCB.MF 00000000 

TCB.DF OOOOOOOO 

TCB.SVI OOOOOOOO 

TCB.MM OOOOOOOO 

TCB.RSCH OOOOOOOO 
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CTX 002*60 
CTX.FPTR OOOOOOOO 
CTX.BPTR OOOOOOOO 
CTX.TC8 00002780 
CTX.TRCE OOOOOOOO 
CTX.rSii C00*7tru uCu1o3AC 
CTX.PSTD OOOOOOOO 

CTX. REGS 20000000 00018*87 OOOOOOOO 00000018 00000008 FFFFFFFF 000000E8 50202020 
00000032 20000000 OOOOOOOO 000O2EO0 00000021 00011074 OOOOOOOO 00005679 

CTX.SCR5 OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

CTX.SFLT OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

CTX.DFLT OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
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* * 
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« * 

*.. ...........* 



I 



TCB 


002B60 


TCB.FPTR 


00002B60 


TCB.BPTR 


00002B60 


TCB.OPTR 


OOOOOOOO 


TCB. CTX 


00002E40 


TCB.FLGS 


OOOOOOOO 


TCB.RTCV 


OOOOOOOO 


TCB.ET* 


OOOOOOOO OOOOOOOO 


TCB.TPTR 


OOOOOOOO 


TC9.PBLK 




TCB.PRC* 


00,000000 


TCB.PPCB 


OOOOOOOO 



tJ3 
I 
t-- 



00 

I 
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M 
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O 
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o 

to 



CONTENTS 


OF "IcMCPf PRC0UCE3 


TCB.PRCC 


OOQOQCOO 


TC3.PRCD 


oQooaoao 


TCB.PRCe 


00000000 


TCa.PRCF 


00000000 


SDE.FPTR 


00000000 


SDE.BPTR 


00000000 


SOE.NAME 


2E434044 50202020 


SOE.SAOR 


00018004 


SDE.SIZE 


OOOOQOOO 


SOE.USE 


0000 


SOE.ROLL 


0000 


SDE.FLOS 


00 


SDE.TTPE 


00 


SDE.SREG 




SDE.PREG 


00 


SOE.KEr 


00 


SOE.ASG 


OOOOOOOQ 


SDE.FSEC 


OOOOOOOO 


SOE.SSTP 


0000 


SOE.PRIV 


00 




00 


TCB.TID 


02000000 


TCB.STAT 


OOOOOOOO 


ICB.EQ 


OOOOOOOO 


ICB.PQ 


OOOOOOOO 


ICB.PSH 


OOOOOOOO OOOOOOOO 


ICB.FLIH 


OOOOOOOO 


ICB.IPCB 


OOOOOOOO 


ICB.LINK 


OOOOOOOO 


ICB.HEAO 


OOOOOOOO 


ICB.1CL 


OOOOOOOO 


ICB,27CL 


OOOOOOOO 


ICB.3CL 


OOOOOOOO 


ICB.6CL 


OOOOOOOO 


ICB.7CL 


OOOOOOOO 


ICB.6KH 


OOOOOOOO 


rCB.RCNT 


0000 


ICB.FLGS 


0000 


TCB.UAIT 


00000400 


TCB.OPT 


32108008 


TCB.CLC 


OOOOOOOO 


TCB.TGO 


OOOOOOOO 


TCe.VOFF 


0000 


TCB.RSV 


0000 


TCB.RSAC 


0000 


TCa.RCNT 


0000 


TCB.PRI 


02 


TCB.RPRl 


02 


TC8.DPRI 


02 


TCB.MPRI 


02 


TCB.CTSW 


C800424C 


TCB.SLOC 


0001 900C 


TCfl.CTOP 


0001 3D02 


TCB.UTOP 


OOOOOOOO 



BY i PANIC :)UMP 



50202020 OOOOOOOO OOOOOOOO OOOOOOOO 
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CONTENTS OF MEMOCY PROOUCcD 3T 4 PANIC OUMP 
TCB.TTOP OOOOIJOOO 
TCe.OBOT 00000000 
TCB.OCB 00000000 
TCB.TEQM 00000000 
TCB.SEG 00000000 
TCB.LRA 

TCB.PSTD 00000000 
TCB.SSTO 00000000 
TCB.ADCK 00000000 
TCB.NXSP FFFFFFFF 
TCB.USSP 00000000 
TC8.SYSP 00000000 
TC8.SHSZ OOOOOOOD 
TCB.NSHO 00 
00 
TC6.HSEG 0000 
TCB.SOPT OOGOOOOO 
TCB.OLtr 00000000 
TCB.VOL 00000000 
TCB.SVAO 00019FF0 
TCB.THP1 00000000 
TCe.USER 00000000 oooooooo 

00000000 oooooooo 

TCB.SYS 00019EB8 
TC8.SYS1 oooooooo 

TCB.srsz ooooooao 

TCB.SrSJ 08038100 
TCB.SYS4 oooooooo 

Tce.srss oooooooo 

TCB.FO 

TCB.VOLN oooooooo 
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TCB.FN 
TC6.EXT 



oooooooo oooooooo 
oooooooo 



TCB.OATE oooooooo 

TCe.ACCT 0000 

TCB.RC 0000 

TCS.USRA OOOOOOOO OOOOOOOO 

TCB.UACT 0000 

TCB.GACT 0000 

TCB.HID 00 

TCB.GIO 01 

0000 
TCB.CPLM OOOOOOOO 

TCB.CPU 0002EF38 00000686 OOOOOOOO OOOOOOOO 
TC3.ACUH 

TCB.MTIM 001242AC 
TCS.RTIH OOOOOOOO 
TCB.HOLD 

TC6.TMWT 0015404E 
TCP. ROUT OOOOOOOO 
TCB.STIM OOOOOOOO 
TCe.TSL 0000 
TCB.RLSL OOOO 
TC6.T1HR 0001 
TCB.LOAO 00 

00 
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CO 






CONTENTS OF MEMORY PRODUCED BY 4 PANIC DUMP 

TCB.XFRS OOOnOOOG 

TCB.IOC D003 

TCB.I04C GOOD 

TCB.IOBL J000201C 

TCB.CI08 0OQ07O1C 

lOB.NXT 00000000 

lOB.RFLG 0000 

lOB.PRI 02 

lOB.TYPE 01 

lOS.OONE 00000000 

lOB.DCa 00007CCC 

108. TCB 00002B60 

lOB.ESR 0000A«04 

lOB.UPBK 00012ECO 

I0B.P9LK O0012EC0 

lOB.FC CO 

lOB.LU 03 

IOB.ST*T 00 

lOB.DOPS 00 

lOB.SAOR FFFFFFFF 

lOB.EAOR 000U40F 

108. RAND 00000000 

108. LUE 5B007CCC 

I0B.SV1X 4C030000 

lOS.WCHN 00000000 

lOB.CYL 0002 

lOB.SECT 01 

lOB.LSEC 01 
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TCB.UCTX 00002E40 



*...8 



CTX.FPTR 00000000 

CTX.BPTR 00002E40 

CTX.TCB 00002860 

CTX.TRCE 00018E3* 

CTX.PSW 00047062 00Q259SE 

CTX.PSTO 00000000 

CTX.REGS 00000000 00000000 00000000 00000000 00000000 00000000 ooooooco cooooooo 

00000000 00000000 00000000 00000000 00000000 00000000 00000000 cooooooo 



*...4 

*• .pb. • T' 



00 
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o 



o 
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TC9.LPU 
TCB. QUE 

TCB.NLU 
TCB.UCON 
TCB.LTFL 
TC8.FMLU 
TCB.LTA8 
TCB. TUB 
TC8.AF 
TCB. II 
TCB.MF 
TCB. OF 
TC8.SVI 
TCB. MM 



00 

00 

00 

00 

00000000 

00002E00 

00000000 

EB011074 

00000000 

00000000 

00000000 

00000000 

00000000 

00000000 

00000000 
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CO 
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TCB.R"^'' H 00000000 
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CTX 002E40 
CTX.FPTR QOOOOOOO 
CTX.BPTR 00000000 
CTX.TCB 00002860 
CTX.TRCE 00000000 
CTX.PSW 000472FO 00019632 
CTX.PSTD 00000000 

CTX. REGS 00000000 00005682 00000000 00000000 OQOOCOOO FFFFC003 0001A3C0 00000000 
00018E38 00000010 00000000 0001980A 00000000 0000001F 000133E8 0001A3F3 

CTX.SCRG 00000000 00000000 00000000 00000000 00000000 00000000 00000000 cooooooo 
00000000 00000000 00000000 OOOOOOOb 00000000 00000000 00000000 00000000 

CTX.SFLT 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

CTX.DFLT 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 



*..r . , , ,2 * 

* V « * 

A...B ...3 * 

* * 

*,.,, .....* 

* , .,...........* 

* * 



OPB 009160 
TKQ.LOKS 0000 
TKQ.CNT 0000 
THO.FRNT 00000000 

aPB.TPTR 00000000 
QPB.OHTC 00000000 
0P6.MTID OOOO 
CPB.ETID 0000 
QPe.STAT OODO 
OPB.BHAP 8000 
0P6.ACNT 01 
QP8.LCNT FE 
QPfl.IO 00 

00000000 00 



txi 
I 

en 



TCB 



1F3480 



TCB.FPTR 001F2FE0 

TCB.BPTR 001F2FE0 

TC6.QPTR 00009180 

TCB. CTX 0O1F37B0 

TC8.FLGS 00000000 



♦ ../ 
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to 



CONTENTS 


OF MEMORY PRODUCED 3Y 4 PANIC DUMP 


TCB.RTCV 


OOQQOQOO 


TCB.ETA 


00000000 OUOOOOOO 


TCB.TPTR 


00000000 


TCB.PBLK 




TCB.PRC* 


00000000 


TC8.PRCB 


00000000 


TCB.PRCC 


00000000 


TCB.PRCO 


00000000 


TCB.PRCE 


00000000 


TCB.PRCF 


00000000 


SOE.FPTR 


Q01F301C 


SOE.BPTR 


001F33BO 


SOE.NAME 


42312020 20202020 20202020 20202020 00000000 


SOE.SAOR 


0003EOOO 


SDE.SIZE 


OOOQSOOO 


SDE.USE 


0000 


SOE.ROLL 


0000 


SOE.FLGS 


48 


SOE.TrPE 


01 


SOE.SREG 




SOE.PREG 


09 


SOE.KEY 


00 


SOE.ASG 


00000000 


SDE.FSEC 


00000000 


SOE.SSTP 


0000 


SDE.PRIV 


00 




00 


TCB.TIO 


03000001 


TCB.STAT 


08000000 


ICB.EQ 


00000000 


ICB.PO 


00000000 


ICB.PSH 


00000000 00000000 


ICB.FLIH 


00000000 


ICB.IPCB 


00000000 


ICB.LINK 


00000000 


ICB.HEAD 


00000000 


ICB.1CL 


00000000 


ICB.27CL 


00000000 


ICB.3CL 


00000000 


ICB.6CL 


00000000 


ICB.7CL 


00000000 


ICB.6RX 


00000000 


IC8.RCNT 


0000 


ICB.FLGS 


0000 


TCB.HAIT 


00000000 


TCB.OPT 


00200C2C 


TCB.CLC 


00000000 


TCB.TGO 


00000000 


TCB.VOFF 


0000 


TCB.RSV 


0000 


TCB.RSAC 


0000 


TCB.RCNT 


0000 


TCa.PRI 


96 


TCB.RPRI 


96 
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CONTENTS 


OF HEMORT PRODUCED 
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TCa.DPRI 


96 




TCB.MPRI 


03 




TCB.CTSW 


00000000 




TCB.SLOC 


00090000 




TCB.CTOP 


00042FFE 




TCB.UTOP 


00001880 




rCS.TTOP 


00001880 




TCB.OBOT 


00000000 




TCB.OCB 


00000000 




TCB.TEeH 


00000000 




TCB.SEG 


001F3400 




TCB.LRA 






TCB.PSTD 


00123E68 




TCB.SSTO 


003E0006 




TCB.ftOCK 


00000000 




TCB.MXSP 


OOOFFFFF 




TCB.USSP 


00000420 




TCB.SYSP 


00000420 




TCB.SHSZ 


00005100 




TCB.NSHD 


00 
00 




TCB.HSEG 


0009 




TCB.SOPT 


00000000 




TCB.OL«r 


00000000 




TC8.V0L 


00000000 




TCB.SVAO 


00000000 




TCB.TNP1 


000205E6 




TCB.USER 


OOOOOOOO 00000000 
00000000 OOOOOOOO 




TCB.STS 


00000051 




TCB.SYS1 


00000021 




TCB.SrSZ 


01000000 




TC8.SYS3 


00000007 




TCB.STS4 


00000001 




TCB.SYS5 


OOOOOOOO 




TCB.FD 






TCB.VOLN 


4DS44020 




TCB.FN 


4241434B SS502020 




TCB.EXT 


54534B00 




TCB.OATE 


05275DSJ 




TCB.4CCT 


0000 




TCB.RC 


0000 




TCB.USR* 


OOOOOOOO OOOOOOOO 




TCB.UACT 


0000 




TCB.GACT 


0000 




TCB.MIO 


00 




TCB.GIO 


02 
0000 




TCB.CPLM 


OOOOOOOO 




TCB.CPU 


OOOOOOOO OOOOOOOO 


OOOOOOOO OOOOOOOO 


TCB.ACUM 






TCB.MTIM 


OOOOOOOO 




TCB.RTIM 


OOOOOOOO 




TCB.HOLD 






TCB.TMWT 


OOOOOOOO 




TCB.ROUT 


OOOOOOOO 
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CCMfcNTS 


OF ■< = hoi;y pfuOuCcD 3y 


TCB.STIM 


02Bie7JJ 




TCe.TSL 


0000 




TC8.RLSL 


0000 




TCB.TIMR 


0000 




TCB.LOAO 


00 
00 




TCB.XFRS 


00000001 




TCS.IOC 


0000 




TCB.I04C 


02B4 




TCB.IOBL 


001F36JC 




TCB.CIOB 


00000000 




lOa.KXT 


001F3764 




lOB.RFLG 


0000 




lOB.PRI 


96 




lOB.TYPE 


01 




lOB.DONE 


00000000 




106, DCB 


00000000 




lOB.TCB 


00000000 




lOB.ESR 


00000000 




lOB.UPBK 


oooooooo 




lOB.PBLK 


00000000 




lOB.FC 


00 




lOB.LU 


00 




lOB.STAT 


00 




lOB.OOPS 


00 




lOB.SADR 


oooooooo 




I0B.EA3R 


oooooooo 




lOB.RANO 


oooooooo 




lOB.LUE 


oooooooo 




I0B.SV1X 


oooooooo 




lOB.WCHN 


oooooooo 




lOB.CTL 


0000 




lOB.SECT 


00 




lOB.LSEC 


00 
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TCe.UCTX OO1F37B0 



*..7. 



CTX.FPTR OOOOOOOO 

CTX.BPTR OOOOOOOO 

CTX.TCB OOOOOOOO 

CTX.TRCE OOOOOOOO 

CTX.PSU OOOOOOOO OOOOOOOO 

CTX.PSTO OOOOOOOO 

CTX.REGS OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



00 
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to 



TCB.LPU 


01 


TCB.QUE 


01 




00 


TCB.NLU 


08 


TCB.UCON 


OOOOOOOO 


TCB.LTFL 


001F3710 


TCB.FHLU 


OOOOOOOO 


TCB.LTA8 


OOOOOOOO 


TCB.TUB 


oooooooo 
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TCB.AF 

TCB.II 

TCB.MF 

TCB.DF 

TCB.SVI 

TCB.MM 



OOOQQOOO 

ooooooao 

00006000 
00000000 
00000000 
00000000 



TCB.RSCM 00000000 



CTX 



1FJ780 



CTX.FPTR 00000000 

CTX.BPTR 00000000 

CTX.TCB 001F3480 

CTX.TRCE 00000000 

CTX.PSW 000477F0 00000100 

CTX.PSTD 00123E68 

CTX.REGS OOOOOOOQ OOOOOOOC 00000000 00000000 00000000 00000000 00000000 00000000 
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00090000 



*..4. 



*..>h 



CTX.SCRG 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
00000000 00000000 00000000 00000000 00000000 OOOOOOCO 00000000 00000000 

CTX^SFLT OOOOOOCO 001F345C 000QQ79C OOOOOOOQ C0QQ0640 001F3S60 001F5S5C OOOOOQOO 



CTX.DFLT 001F3090 00000000 00000000 00000000 00000000 OOOOOOCO 00000000 00000000 
OOOOQOQO OOOOOOOQ OOOOOOOQ OOOOOOOQ OOOOOQOO OOOOOOOQ 42322020 20202020 



.62 



00 
I 



TC8 


1F2FE0 


TC8.FPTR 


0Q1F343Q 


TCB.BPTR 


001F3480 


TCB.OPTR 


00009190 


TCB.CTX 


001F3310 


TCB.FLGS 


OOOOOOOQ 


TCB.RTCV 


OOOOQOQO 


TCB.ET* 


OOOOOQOO OOOOOOOQ 


TCB.TPTR 


OOOOOOOQ 


TCB.PBLK 




TCB.PRCA 


OOOOOOOQ 


TCB.PRC8 


00000000 


TCB.PRCC 


OOOOOQOO 


TCa.PRCO 


OOOOOQOO 


TCB.PRCE 


OOOOOOOQ 


TCa.PRCF 


00000000 


SOE.FPTR 


OOOOOQOO 


SOE.BPTR 


001F34BC 


SOE.NAHE 


42322020 20202020 20202020 


SDE.SAOR 


00043000 
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sae.sizc 


00005000 




SOE.USE 


0000 




SDE.ROLL 


0000 




SDE.FLGS 


48 




SDE.TYPE 


01 




SOE.SREG 






SOE.PREG 


09 




SDE.KEy 


00 




SQE.ASu 


00000030 




SOE.FSeC 


00000000 




SDE.SSTP 


0000 




SOE.PRIV 


00 
00 




TCB.TIO 


04000002 




TCB.ST4T 


oaooooQo 




ICB.EO 


00000000 




rCB.PO 


00000000 




ICB.PSH 


00000000 00000000 




ICB.FLIH 


00000000 




ICB.IPCa 


00000000 




ICB.LINK 


00000000 




ICfi.HE«0 


00000000 




ICB.1CL 


00000000 




ICB.27CL 


00000000 




ICB.3CL 


00000000 




ICB.6CL 


00000000 




ICB.7CL 


00000000 




ICB.6RX 


00000000 




ICB.RCNT 


0000 




ICB.FLGS 


0000 




TC6.W»IT 


00000000 




TCB.OPT 


00200CZC 




TCB.CLC 


00000000 




TCB.TGO 


00000000 




TCB.VOFF 


0000 




TCa.RSV 


0000 




TCB.RSAC 


0000 




ICB.RCNT 


0000 




TC8.PRI 


96 




TCB.RPRI 


96 




TCB.OPRI 


96 




TCB.MPRl 


OB 




TCB.CTSU 


00000030 




TCB.SLOC 


00090000 




TCB.CTOP 


00047FFE 




TCB.UTOP 


00001880 




TCB.TTOP 


00001880 




TCB.OBOT 


00000000 




TCB.OCB 


00000000 




TC9.TE0H 


00000000 




TCB.SEG 


001F2FSO 




TCB.LR* 






TCB.PSTO 


00123E5F 




TCB.SSTO 


003E0006 
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TCa.ADCK 


30000000 




TCB.MXSP 


OOCFFFFF 




TCB.USSP 


JOOOOJEO 




TCB.SYSP 


00000360 




TCB.SHSZ 


00005100 




TCB.NSHD 


30 
00 




TCB.MSE5 


0009 




TCB.SOPT 


OOOOOOQO 




TCB.OLAT 


00000000 




TCS.VOL 


00000000 




TCB.SVAD 


00000000 




TCB.TMP1 


000205E6 




TCB.USER 


OOOOOOQO OOOOOQOO 
00000000 00000000 




TC8.SYS 


00000051 




TCB.SYS1 


00000021 




TCB.SYS2 


01000000 




TC8.SrS3 


00000007 




TC8.SYS4 


00000001 




TCB.SYS5 


OOOOOOQO 




TCB.FD 






TC6.V0LN 


4054*020 




TCB.FN 


4241434B 55502020 




TCB.EXT 


54534BQ0 




TCB.DATE 


03275053 




TC8.4CCT 


0000 




▼ *• B »** 


ne\nn 

v/vww 




TCB.USR* 


OOOOOOQO 00000000 




TCB.UACT 


0000 




TCB.GACT 


0000 




TCB.MID 


00 




TCB.GIO 


02 
0000 




TC6.CPLM 


OOOOOOQO 




TCB.CPU 


00000000 OQOQOOOO 


OQOOQOOO OOOOOQOO 


TCB.ACUH 






TC8.WTIM 


OOOOOQOO 




TCB.RTIM 
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FF010000 
00000000 
FFOIOOQO 
00000000 
FF010000 
00000000 
FF010000 
00000000 
FF010000 
00000000 
00000000 
00000002 
00000000 
00000000 
00000000 
00000000 
00000400 
00009160 
00000000 

00081 F 

00000000 
0001FJ24 
00000000 
OOOOOFFF 
00002E40 
00000000 

00095F 

00000000 
00000000 

ooooooco 

DE2092D6 



ROOuCE? a 

00035A9C 

68018801 

68018801 

43004003 

00000630 

22462266 

00000003 

24FC24FC 

24FC24FC 

058124FC 

24FC24FC 



24FC24FC 
24FC24FC 

001F33a0 
00000000 

0000560C 
002B0OO0 
OOOOOOCO 
00000000 

oooocooo 
oooooooo 
oooocooo 
oooooooo 
oooooooo 
oooooooo 



oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 

00100000 
0000001F 

oooooooo 

0002859A 

oooooooo 
oooooooo 

00000400 
00008484 
00019F14 

oooooooo 
oooooooo 

oooooooo 
oooooooo 
oooooooo 

DE2092D6 



Y A PANIC DUMP 

oooooooo oooooooo 
oooooooo oooooooo 

00047000 0001 027C 
3E640000 oooooooo 
00047050 00010F0A 
229822DE 21B0236A 
00047000 0001D8B8 
24FC24FC 24FC24FC 
24FC24FC 24FC24FC 
05C124FC 060124FC 
24FC24FC 24FC24FC 

***SAME AS A 
24F024F6 24FC24FC 
24FC24FC 24FC24FC 

***SAHE AS A 
OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO 

***SAME AS A 
00001952 OOOOOOOO 
0OOO5D50 0OOOC7F4 
OOOOOOOO OOOOOOOO 
OOOOOOOO 00O0C7F4 

OOOOOOOO oooooooo 

oooooooo 0000C7F4 

oooooooo oooooooo 

oooooooo 0000C7F4 

oooooooo oooooooo 

naoooooo 0000C7F4 

oooooooo oooooooo 

oooooooo 0000C7F4 

oooooooo oooooooo 

oooooooo 0000C7F4 

oooooooo oooooooo 

oooooooo 0000C7F4 

oooooooo oooooooo 

oooooooo 0000C7F4 

oooooooo oooooooo 
oooooooo oooooooo 

oooocooo OOOQFFOO 
oooooooo 00007CCC 
0001 BC92 oooooooo 
000133E8 0001A3F3 
00000006 001F3FE0 
00002360 00027854 
OOOOOOOO OOOOOOOO 
»**SAME AS A 
OOOOOOOO OOOOOOOO 
0004205A 00047052 
0004F200 00007F08 
OOOOOOOO OOOOOOOO 
000472FO 00000010 

OOOOOOOO oooooooo 

***SAME AS A 

oooooooo oooooooo 
oooooooo oooooooo 
cooooooo oooooooo 

58540018 48309202 



oooooooo 

00000040 
05000CCF 
430C4003 
00047000 
238E21B0 
24E824FC 
0401041D 
044124FC 
24FC24FC 
24FC24FC 

aOVE *** 

24FC24FC 
24FC24FC 

BOVE *** 

OOOOOOOO 
OOOOOOOO 

BOVE *** 

00009BDC 
24FCO000 
00009BDC 
24FC0000 
00009B0C 
24FCO0OO 
00009B0C 
24FC0000 
00009B0C 
24FCO00Q 
00009BDC 
24FC00O0 
00009BDC 
24FC00OO 
000096DC 
24FC00OO 
00009B0C 
24FC0000 
0OOOC7F4 
1D983000 
00007300 
OOOOOOOO 
000iaE38 
00047200 
00027C88 
OOOOOOOO 
OOOOOOOO 

BOVE *** 

00000006 
0001F204 
00000009 
0002828C 
OOOOOOOO 
OOOOOOOO 

BOVE *** 

OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
4035002C 



15:33 
OOOOOOOO 
00035A9C 
43000080 
15040000 
0001CED4 
21802368 
24FC24FC 
24FC24FC 
048124FC 
24FC24FC 
24FC24FC 



27 08/22 

OOOOOOOO 

OOOOOOOO 

F81001FF 

OOOOOOOO 

00047000 

24142426 

24FC24FC 

24FC24FC 

04C124FC 

24FC24FC 

24FC24FC 



/83 

COOOOOOO 

000105EC 

00621313 

OOOOOOOO 

21B021BA 

OOOOOOOO 

24FC24FC 

24FC24FC 

050124FC 

24FC24FC 

24FC24FC 



24FC24FC 24FC24FC 24FC24FC 
24FC24FC 24FC24FC 24FC24FC 

OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO 



0A824500 
00005S50 
128E0C00 
00005068 
128E0000 
00005F80 
128EO00O 
00006198 
128EOO00 
000063BO 
128E0000 
O00065C8 
128E0000 
000067EO 
128EOOOO 
000069F8 
128E0000 
00006C10 
20AO0O0O 
OF006F4C 
OOOOOOOO 
00005682 
00000001 
00000070 
OOOOOOOO 

oooooooo 

OOOOOOCO 

FFFFFFFF 
000278E8 
00002DDC 
00002B60 
OOOOOOOO 
OOOOOOOO 



00005BS0 
00009C5C 
00005063 
00009C5C 
00005F80 
00009C5C 
00006198 
0O009C5C 
00006360 
00009CSC 
00006SC8 
00009C5C 
000067EO 
00009C5C 
O00O69F8 
00009C5C 
00006C10 
00009C5C 
00006E28 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
00000010 
OOOOCOOO 

oooooooo 
oooooooo 

oooooooo 
oooooooo 

O0OO2B6O 

oooooooo 

OOOOOOOO 

oooooooo 



OOOOOOOO 00008870 

oooooooo 00008C90 

oooooooo 00009080 

24317435 01004230 



FF0C0001 
FF060C7E 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 

oooooooo 

OOOOOOOO 

oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 

FFFFFFFF 

oooooooo 

0001 ADB2 
0001980A 
00000008 

oooooooo 
oooooooo 
oooooooo 

oooooooo 

0000072B 
0002C874 
OOOOOOOO 

oooooooo 

OOOOOOOO 

oooooooo 

OOOOOOOO 

oooooooo 

805E5835 



PASE 61 

* ...a..z.. * 

* .S..I UL * 

* P...R.U..OC...X....B.. * 

* «.xac.s.>D C.£... * 

* O..PP.._...P...NT..P.IOI: * 

* !V"4"F"F".''*|0*J«.IO!0#Nt.$8.... * 

* ...P P. ..X8SH$. $.$.$. $.$.$. * 

* S.I.$.$.S.$.$.S $.$.$.$.!.$■ * 

* $.S.$.$.$.$.$.t..A$...$..A$...$. * 

* . AS. ..$.. AS. ..S.S.t.S.S. $.$.$.$. * 

* S.S.S.S.S.S.S.S.S.S.S.S.S.S.S.S. * 

* - SAME - * 

* S.S.S.S.SPSVS.S.S.S.S.S.S.S.S.S. * 

* s.s.s.s.s.s.s.s.s.s.s.s.s.s.s.s. * 

* - SAHE - * 

* T 30 * 

* * 

* - SAHE - * 
* V\...R \..E...CP.... * 

* \ 3H.... * 

* •■•■••■•■■•■■•GT$aa»a«jH«*«\«*«a * 

* \ * 

* GTS _....\.... * 

* \ A * 

* ....GTS *....\.... * 

* \ CO.... * 

* >■>■••■•••■•• •GTS* ■ •■•C0*««\««*« * 

* \ EH.... • 

* \ G .... * 

* •••••••■•••••« GT S*«««ftG ••«\««*« * 

* \ IX.... * 

* ... a .......... GTS .... .1 X. .. \ ... a * 

* \ L * 

* GTS L....\.... * 

* ••■■■•••••••••■*a»GT ««**NC«««« * 

* 0._.0L * 

* SP * 

* L V -2 * 

* < 8 * 

* 3Ha.«S..R...aP * 

* 1 * 

» + ...T a * 

* a...... * 

* - SAME - * 

* ............ a. a. ...... a a a . a a a. . . * 

* a.SSa.aaa. Z..PK.aRaaaXr1a.....a* * 

* R -\aa+ aaHT ♦ 

Ik ♦ * 

* ...a RP * 

* a a .. .. .. .a a a aa aa aaa ... a .. aa ...a. * 

* - SAME - * 

* P.... * 

* ., • 

* Oa... * 

* * .V* .VXT..H0.R85./S1T5..B0.*X5 ♦ 



C3 

I 

o 



l4!> 
00 

I 

o 
w 



o 
o 

o 



CONTENTS 

OC09E0i 

000400; 

000420; 

O00A<,0; 

000460; 

OOOASO; 

OOOAAO: 

00C4C0: 

OOOAEO: 

OOOBOO: 

000B20; 

000B40: 

00OB60: 

000S80: 

OOOBAO: 

OOOBCO: 

OOOBEO: 

OOOCOO: 

OOOCZO; 

O00C40i 

000C6C; 

OOOCBO: 

OOOCAO: 

OOOCCO: 

OOOCEO: 

000000; 

OOOOZO: 

000040; 

000060: 

000080: 

OOOOAO; 

OOODCO; 

OOODEO: 

OOOEOO; 

000E20: 

OOOEAO: 

00OE6O: 

000E80: 

QOOEAO: 

OOOECO: 

OOOEEO: 

OOOFOO: 

0OOF2O: 

0OOF4O: 

OOOF60! 

000F80: 

OOOFAO: 

OOOFCO: 

OOOFEQ: 

001000; 

001020; 

001040; 

001060; 

001080; 

0010AO: 

0010C0: 

OOIOEO; 



OF Hc>10Rr 
C054F330 
233F417Q 
009D0J36 
80405835 
9D23CJ30 
18009826 
E3640000 
25J14C35 
4170856E 
42608830 
00004S75 
02760000 
E660800C 
878C1800 
08761171 
000F23eE 
FF8E4064 
24637465 
87080766 
001J4330 
4230eE02 
76350100 
5A640004 
42308622 
02750DAE 
80245854 
76740000 
00182721 
FD5A9B26 
00134330 
18002470 
00114330 
41704000 
C5600011 
DE208E7A 
E67086C0 
4B640002 
40340014 
585S00E8 
00094330 
24315854 
01620735 
F5300000 
587500E8 
FFFFC660 
00C44535 
DA2500C5 
75350162 
00A24380 
O0OA7J45 
00BC4064 
423082A2 
01000337 
9A264170 
24615165 
002142J7 
0018D365 



PFODUCED 
2GOOC00C 
86407325 
0000C530 
00S4F330 
00014230 
C3334230 
4260305E 
00CQ1800 
24767475 
18000733 
00F42671 
27614875 
40640014 
98260833 
54740010 
40750110 
00141800 
0OF6233E 
46640002 
818E2621 
08439023 
1800E660 
03360000 
18005854 
417083EA 
00185875 
18000860 
E6604000 
26210460 
809*0560 
74750100 
80764855 
C0749B26 
4230849C 
C8607FFF 
58540018 
10622664 
7345009A 
D3550001 
80405854 
00185135 
0J074054 
0B34233S 
D3670001 
20004065 
00*22387 
487500C6 
C8600020 
FF8E7635 
009*7364 
00147345 
C460007F 
24357435 
40000074 
00A47345 
00022461 
0103D375 



BY A PANI 
43308050 
00944873 
C0182339 
20000000 
8FFC2466 
835CC460 
13005854 
41708586 
00F62335 
58540018 
0B674300 
00F40667 
73450094 
203CC460 
48770000 
48750114 
2721DE20 
90232320 
10622664 
DE209Q50 
08332332 
802E4Q64 
E7340010 
00182461 
24787674 
0084F370 
FF004064 
24FC4064 
007F5854 
001B4330 
2337C560 
0O2CC550 
08334230 
E660FF56 
E67086D8 
24607665 
4300FFC0 
E6304000 
23022551 
00182531 
00B4S835 
0O0E5S54 
E630FC44 
11684065 
00C4DA27 
74350162 
40740014 
9A265S35 
01625875 
C014406S 
00982721 
58540018 
01000257 
05300008 
00982721 
74650084 
OOF8C370 



DUMP 
D3350C70 
03044220 
41708622 
2133E670 
74650100 
007FC560 
00182432 
0425009F 
C5600000 
D23500F* 
301E5854 
7345009* 
43008C06 
007F5854 
1171F570 
27712312 
90405654 
417084*6 
40650020 
E6608018 
18005854 
00142468 
E3640000 
766500*0 
00004170 
20000000 
00004170 
00140834 
0018C560 
856*0833 
00004330 
7FFF4330 
84F8C460 
40640014 
58540018 
0100E660 
58540018 
24FC4034 
48340016 
03070855 
00B4553S 
00182430 
40340014 
0OC4C330 
40FFFFFD 
21344170 
7374000C 
00B42631 
00D87437 
00B04170 
7374000* 
7374000* 
4074000* 
2235DE20 
03640008 
43370002 
00402133 



033C0020 
802*4873 
E665009D 
80824074 
23350330 
00202383 
74350100 
4300FF68 
45308830 
24617665 
00182471 
40340016 
98260330 
0018C560 
00000*** 
24704075 
00182466 
2302230F 
9B26C460 
40640014 
00182437 
75640000 
42608044 
43308660 
40000074 
23J7247E 
40000074 
73450098 
000E4330 
42308552 
808*4300 
84FA1800 
007FCS60 
58540018 
48350020 
FF104064 
24327435 
0014DE20 
2118C560 
21172531 
00802183 
743500*0 
407400OC 
7F004330 
4170808* 
S06C220F 
24692431 
503S00B4 
00004230 
4000C074 
03074074 
03075854 
02640008 
8C0CE660 
7374000* 
03074864 
03650102 



15:33; 
21375835 
0C164230 
24702453 
0C142435 
00024230 
E7640010 
423080*4 
9B260833 
48340016 
01005865 
517500*4 
40740004 
00014230 
007F4330 
42308026 
01140265 
74650100 
07664065 
007FC56C 
08347345 
74350100 
246E7464 
9*261800 
487500F0 
43008630 
76740000 
24624564 
24634563 
885EC560 
0560000F 
8516C560 
C8707FFF 
001B4330 
4170803E 
03374065 
00145854 
0100E630 
8E087345 
007F2338 
C3507F0O 
503500BO 
4330FF*E 
OE208O64 
801E5575 
S83500B4 
D33500C5 
03075835 
S53500B0 
FFAE4170 
C5300008 
000*4170 
00184834 
7345009* 
400024FC 
03070365 
00004064 
24702433 



27 08/2 
0084F330 
81424300 
43008110 
74350100 
8894C330 
417085B6 
4300FFOC 
4230880* 
21129*26 
00ECD375 
586500EC 
50640000 
8EEC0330 
S044C560 
48750110 
47000116 
23349023 
00725065 
00144330 
00982465 
23374170 
00002339 
4220803E 
407500*0 
9*264664 
4874000* 
00164330 
00164350 
00144330 
21352461 
00124330 
4075002C 
84FEC560 
7345009* 
002C0307 
00187345 
880C2133 
00980307 
C5600020 
21359*25 
453500*2 
48340014 
4834000E 
0OEO213D 
27315035 
08332335 
00B44S3S 
21835035 
30044300 
22355854 
4C00C074 
00160217 
2621DE20 
40640014 
007OC46O 
00204074 
763500*0 



2/83 
02000000 
8E9*E665 
9B26E670 
42309006 
00080337 
4170840* 
417083*0 
C460007F 
E3640000 
01040276 
03750102 
73450098 
00024230 
00202380 
26710570 
ie00E660 
4220870E 
00384300 
8196C560 
74650100 
84542437 
48640002 
2535083J 
037500FZ 
00164230 
23242478 
88065854 
FCDE4300 
80*20560 
77650100 
807EC560 
73450098 
00122335 
4300FE26 
OE208E5C 
009*0766 
E630FC02 
58540018 
2389C560 
23039*26 
23837635 
403SO0C6 
42108076 
D36740FF 
00840*25 
417080SE 
00*22383 
00804535 
FFC64074 
00187365 
9B260333 
24377635 
8C1E246* 
58540018 
0021CS60 
00225854 
42308036 



P*GE 62 
..SO ...00.PS5.POO. 17X5.. SO.... 
«?*P.LS5..HS..B .*HS..B0.30...FE 
..S6..E0..*9«P."FE..SPS3C....SFP 
.3X5. .SO ...I3FP..BT..S5T5..B0.. 
.*OO..BO..SFTE..«I500..BO..C0...7 
...I.3B0.\D ..E . «.G0..«P.6*P.. 
00. .8 .'..XT..$2T5..eO.$C..\*P./ 
X1»S.a..*P..ZX..C..H.$.3BO..O .. 
*P.N$VTU.y«5E <.C0.<H4..I..SC0.. 
B .0...3XT..R5.Z$«VE..XE.LSU..RV 
..HU.T&0.GC...XT..SOQU.$XE.LSU.. 
RV..'*HU.T.GSE..84..ST..PD..SE.. 
F ..SD..SE..C..V.tCO..BO.LCO..BO 

S.3 <0 ..XT..E ..CO.DE . (t. 

.V.QZT..HW...QUP...*BO.(HU..tOEP 

..||I.8U..HU..'Q».S.8U..REG F 

..80....'!" ./XT..SFTE..«4.IIIB .. 
SCTE.V«>.lir«/AP.t«.*..FaE.RPE.8C. 
.X.FKD...Bt08E.^.tO ..E ..CO..E 
..CO..t!'' .PF ..80...4SE..$ETE.. 
B0...C.#.3»2..XT..$7TS..»7*P.T$7 
VS....F ..8D..SHUD..SNT0..«9HO.. 
ZD..S6..G4..CD..B .0.(..B .>«S.3 
BO."..XT..S«VE./'CD. HU.PaU.xSU.R 
RU..*P.J$XVT..*P8.STC..<.(HD..B0 
.SXT..XU..SP ...«7S.VT..HT..«$SX 
VT....H ..8D..APS.aT$BED..C0..XT 
..'IF S.S.80...4SE..SCEC..C0.*C. 
.Z.tdO ..XT..E ..C0.*E ..CO.''E 
..CO..E ..C0.J.3B0.RE ..I5$«UE.. 
..SPTU..«7E ..CO..C...E ..CO..E 
..CO.VHU.«EP..CO.Z..HP..aU./SE.. 
*Pa.aT.t.3B0.XD ..E ..C0..E ..#5 



.XT..*P.>SE..C..t 
.H5./.7aE./..* .\ 
.80..XT..SE...F 



* E ..BO..F .vao. 

* * .ZH ..FP.XXT. 

* FP.aXT..$ VE..F 

* KO...BtOC..8XT..$2T5..FO.LI3FO.. 

* 84..SE..F0S.$.84..* ..SE....XT.. 

* XU.HSU..«.XQH4..I.E ..#8E . *.E 

* ..C0.8XT..X1...UI.X10P.. l5.X«..t 

* $1XT..Q5.4XS.4US.0I.P5.0E5.''«.VS 

* .B.3..aT..XT..S0T5./C0..H4..a5.F 

* U0....«5F0.084..8T..* .DH4..B..V 

* XU.HSG...HaE.0C0..CO..UU. I'SGS. 

* ..F .aE.02'B...*P..X5.4'1P5.4ZX 

* .0E5."#.T5.B!4*P.L",S5.E.3#5*P.* 

* ZX.EHU.F8T..ST..SI$1..X5.4E5."«. 
« U5.8H . .&X5.4S1P5.4U5.0I.P5.0E5 

* ."C..>V5.BXU.XT7..B0..*P..C..FST 

* ..SE..SO..SE.<*Pa.aTE0.."5XT..SE 

* .<aD..SE..'IST,...ST..«P5.aT.t.3 

* BO."D .•XT.,ST....XT.,H4....$7»5 

* ...7S5T5...7aT..RD..SE..ii'' ..$J 

* .tAPa.sTE0.."5* ..F a.s.ao..xT.. 

* $*OE.$SE..'!SD..ST....SE.PD .IE 

* . !B7..$*TE..C7....H0..8D. 8T."XT 

* ..SE..SU.XCP.ai3SE..$P$3V5./B0.6 



INDEX 



A 




Defining memory 


5-7 






boundary requirements 


5-9 


Accounting Reporting Utility 




Device status 


2-13 


account summary report 


4-25 


DIRECTORY command 




capabilities 


4-1 


Disk Dump 


6-3 


commands 


4-8 


DISCSYNC 


8-1 


compilation 


4-4 


capabilities 


8-2 


data collection 


4-3 


efficient operation 


8-6 


end of task codes 


4-33 


end of task codes 


8-6 


individual account 




loading 


8-4 


summary report 


4-27 


messages 


8-8 


input 


4-1 


operating procedures 


8-3 


messages 


4-33 


overview 


8-2 


module assembly 


4-4 


segment size Increment 


8-6 


process 


4-1 


starting 


8-4 


sample reports 


4-22 


time factors 


8-6 


system summary report 


4-23 


DISCSYNC commands 




task establishment 


4-4 


UD AD 


8-4 


Accounting Reporting Utility 




START 


8-4 


commands 




Disk Backup Utility 




CHARGE 


4-17 


blocking factors 


3-5 


END 


4-32 


empty output disk 


3-7 


GET 


4-9 


end of task codes 


3-17 


LOAD 


4-5 


exclusion of files 


3-15 


OPTION 


4-13 


features 


3-2 


PAUSE 


4-31 


file types 


3-1 


REPORT 


4-20 


Inclusion of files 


3-15 


SAVE 


4-29 


Interactive command entry 


3-8 


SEU5CT 


4-11 


magnetic tape format 


3-3 


START 


4-6 


messages 


3-20 


ASSIGN command 




multiple disk back-up 


3-19 


Disk Dump 


6-2 


on-line help guide 


3-10 






operating procedures 


3-5 






operations 


3-14 


B 




output tape 


3-3 






overview 


3-1 


Back-up operation. See Disk 




requirements 


3-5 


Backup Utility. 




secondary directory 




Binary dump. See Disk Dump 




option 


3-6 


Utility. 




selective operations 


3-12 


BIT command 






3-15 


Disk Dump 


6-4 


use of asterisk 


3-16 


Blocking factors 


3-5 


use of hyphen 


3-16 






Disk Backup Utility commands 


3-1 






LOAD 


3-6 


C 




START 


3-7 






TASK 


3-7 


CHARGE command 




Disk Dump Utility 




Accounting Reporting 


4-17 


capabilities 


6-1 


Commands. See specific 




file management data 


6-3 


utility. 




memory requirements 


6-1 






operating procedures 


6-2 






requirements 


6-1 


D 




set print line width 


6-9 






set record length 


6-9 


Data collection 




Disk Dump Utility commands 


6-1 


without MTM 


4-3 


ASSIGN 


5-2 


DDSTM. See modules. 




BIT 


6-4 


DEFINE command 




DIRECTORY 


6-3 


Error Reporting 


5-7 


DUMP 


6-5 


prompt sequence 


5-8 


END 


6-9 
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Disk Dump Uttlity commands 




(Continued) 




FILES 


6-4 


LOAD 


6-2 


PAUSE 


6-9 


RECORD 


6-9 


TASK 


6-2 


UNDUMP 


6-7 


VERIFY 


6-8 


VOLUME 


6-3 


WIDTH 


6-9 


DISPLAY DEVICES command 


8-1 


Dump Print Utility 




APB summary display 


7-8 


capabilities 


7-1 


display sample 


A-1 




B-1 


excimple 


7-5 


execution 


7-2 


file allocation 


7-2 


messages 


7-9 


permanent files 


7-2 


prompt sequence 


7-2 


QPB summary display 


7-7 


requirements 


7-1 


structure display 


7-6 


temporary files 


7-2 


Dump Print Utility commands 


7-1 


LOAD 


7-2 


START 


7-2 


TASK 


7-2 



END command 

Accounting Reporting 

Disk Dump 

Error Reporting 
End of task codes 

Accounting Reporting 

DISCSYNC 

Disk Backup 
Error Reporting Utility 

capabilites 

defining memory 

ending a task 

error reports 

generating reports 

input file 

loading 

MCD file 

paus ing a task 

saving to archival file 

selecting data 

starting 
Error Reporting Utility 
commands 

DEFINE 

GET 

LOAD 

messages 

PAUSE 

REPORT 

SAVE 

SELECT 



Error Reporting Utility 
commands (Continued) 

START 
Error reports 

bulk device I/O 

categor ies 

file manager detected 

memory errors 

summary 

system detected 

system milestones 



File types 

contiguous 

extendable contiguous 

indexed 

nonbuffered indexed 
FILES command 

Disk Dump 
Form feed 



GET command 

Accounting Reporting 
Error Reporting 



Header page 

OS/32 Spooler 



5-6 

5-16 
5-15 
5-17 
5-28 
5-30 
5-20 
5-25 



3-1 
3-1 
3-1 
3-1 

6-4 
2-7 



4-9 
5-6 



2-4 



4-32 






6-9 






5-37 


I,J,K 




4-33 


Input spooling 




8-6 


control statements 


2-1 


3-17 


facilities 


2-1 


5-1 






5-7 


L 




5-37 






5-15 


1 List reports. See error 




5-15 


I reports. 




5-6 


I LOAD command 




5-6 


1 Accounting Reporting 


4-5 


5-7 


1 DISCSYNC 


8-4 


5-37 


1 Disk Backup 


•3-6 


5-36 


1 Disk Dump 


6-2 


5-13 


1 Dump Print 


7-2 


5-6 


1 Error Reporting 


5-6 


5-7 


! M,N 




5-6 






5-6 


i Magnetic tape format 




5-37 


1 file information block 


3-3 


5-37 


1 for multivolume tapes 


3-4 


5-15 


1 volume header 


3-3 


5-36 


1 MARK command 




5-13 


1 Disk Backup 


3-7 
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MARK ON coiranaind 


8-1 


OS/32 Spooler (Continued) 




MCD file 




device status 


2-13 


creating 


5-7 


form feed 


2-7 


data display 


5-13 


header page 


2-4 


displaying 


5-7 


input spooling 


2-2 


sample prompt session 


5-12 


memory requirements 


2-17 


specif ing 


5-7 


messages 


2-18 


Memory 


5-1 


number of devices 


2-8 


banks 


5-2 


operating instructions 


2-4 


blocks 


5-2 


operations 


2-13 


controller 


5-3 


output spooling 


2-3 


modules 


5-3 


spool queue 


2-4 


storage units 


5-4 


starting 


2-5 


Memory configuration file. 




task priority 


2-8 


See MCD file. 




OS/32 Spooler commands 


2-1 


Memory dump. See Disk Dump 




.SPL 


2-11 


Utility. 




START 


2-5 


Memory requirements 




OS/32 System Support 




Disk Backup 


3-5 


Utilites. See Utilities. 




Disk Dump 


6-1 


Output spooling 




OS/32 Spooler 


2-17 


facilities 


2-3 


Messages 


8-8 






Accounting Reporting 


4-33 






Disk Backup 


3-20 


P 




Dump Print 


7-9 






Error Reporting 


5-37 


PAUSE command 




OS/32 Spooler 


2-18 


Accounting Reporting 


4-31 


Mirror Disk Facility. See 




Disk Dump 


6-9 


mirror disks. 




Error Reporting 


5-37 


Mirror Disk Synchronization 








Utility. See DISCSYNC. 








Mirror disks 




Q 




DISPLAY DEVICES command 


8-1 






MARK ON comnand 


8-1 


Queue task priority 


2-8 


SWOP command 


8-1 






Model 3200MPS System 








Dump Print sample 


B-1 


R 




Dump Print structure 








display 


7-6 


RECORD command 




summary error reports 


5-30 


Disk Dump 


6-9 


system detected error 




REPORT command 




reports 


5-21 


Accounting Reporting 


4-20 


Model 3205 System 




Error Reporting 


5-15 


memory error report 


5-29 






memory error summary 








report 


5-35 


S 




Modules 


5-11 






double density storage 


5-3 


Sample reports 




single density storage 


5-3 


account summary 


4-25 


Multiple disk back-up 


3-19 


individual account 








summary 


4-27 






system summary 


4-23 


ID 




SAVE command 








Accounting Reporting 


4-29 


OpteTatlftg ptoeedareB 




Error Reporting 


5-36 


DISCSYNC 


8-3 


SDSTM. See modules. 




Disk Backup 


3-5 


Segment size increment 


8-6 


Dump Print 


7-5 


Accounting Reporting 


4-33 


OS/32 Spooler 


2-4 


DISCSYNC 


8-4 


OPTION command 




Disk Backup 


3-17 


Accounting Reporting 


4-13 


SELECT command 




OPTION subparameters 




Accounting Reporting 


4-11 


.SPL command 


2-12 


Error Reporting 


5-13 


START command 


2-5 






OS/32 Spooler 


2-1 


Selective back-up operations 


3-15 


command file 


2-6 


use of asterisk 


3-16 
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Selective back-up operations 

( Cont inued ) 

use of hyphen 
.SPL command 



TASK command 

Disk Backup 

Disk Dump 

Dump Print 
Task termination codes, 
end of task codes . 



See 



VERIFY command 
Disk Dump 

VOLUME command 
Disk Dump 
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OS/32 Spooler 


2-11 


SPL/32 Spooler 


2-1 


Spool queue 


2-4 


START command 




Accounting Reporting 


4-6 


DISCS YNC 


8-4 


Disk Backup 


3-7 


Disk Dump 


6-2 


Dump Pr int 


7-2 


Error Reporting 


5-6 


OS/32 Spooler 


2-5 


STM. See modules. 




Summary reports 




device errors 


5-33 


memory errors 


5-34 


system errors 


5-30 


system milestones 


5-30 


SWOP command 


8-1 


System Support Utilities. 




See Utilities. 
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UNDUMP command 
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Disk Backup 


3-1 


Disk Dump 


6-1 


Dump Print 


7-1 


Error Reporting 


5-1 


Mirror Disk 




Synchronization 


8-1 


OS/32 Spooler 


2-1 


overview 
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W,X,Y,Z 



WIDTH command 
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D0CUI4ENTATI0N CHANGE NOTICE 



The purpose of this documentation change notice (DCN) is to 
provide a quick and efficient way of making changes to technical 
manuals before they are formally updated or revised. 

The manual affected by these changes is: 

M-Qll EQQ RQ2 Q&/1Z SISIEM SUEEQEI UIILITIES Efi£fitfincfi Manual 



Please disregard Chapter 3 of the System Support Utilities 
Reference Manual, 48-031 FOO R02 , and refer to the attached pages 
for the correct documentation of the Disk Backup Utility. 

The R07.2 OS/32 software package (04-082 FOO M99 R15) contains 
the R03-02 version of the Disk Backup Utility (03-153). However, 
Chapter 3 of the System Support Utilities Reference Manual, 
48-031 FOO R02, documents the R04-00 version of Backup. As a 
result, Chapter 3 of the System Support Utilities Reference 
Manual, 48-031 FOO ROl, has been reprinted and included here to 
provide documentation of the Disk Backup Utility. 

When the R04-00 version of Backup is released, Chapter 3 of the 
System Support Utilities Reference Manual, 48-031 FOO R02, will 
provide accurate documentation of the new version of Backup. 

The previous Appendix B, in revision ROl, of this manual 
documented the Disk Integrity Check Utility (03-080 FOO R08-01). 
This utility was scheduled to be removed from OS/32, but 
ultimately was not. The previous Appendix B has therefore been 
reprinted and included here for reference. This should not be 
confused with the current Appendix B, entitled "Contents of 
Memory Produced by a Panic Dump." 
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CHAPTER 3 
DISK BACKUP UTILITY 



3.1 GENERAL DESCRIPTION 

The Disk Backup LFtility provides a fast method of saving files. 
Files can be transferred from disk to disk, disk to magnetic 
tape, or tape to disk. The starting parameters specified, date 
of backup, and the names of the files backed up are listed. All 
files or selected files can be saved and restored. Files changed 
since a given date can be saved, and files on an output device 
can be replaced. Optionally, the data on the backup device can 
be verified. 

The file types supported by the Disk Backup Utility are: 

• Indexed files 

• Contiguous files 

• Nonbuffered indexed files 

• Extendable contiguous files 

The primary difference between nonbuffered indexed files and 
indexed files is that in nonbuffered indexed files, data is moved 
directly between the user's buffer and the disk, avoiding the 
central processing unit (CPU) overhead and system space memory 
requirements of buffered indexed files. As a result, each 
logical record starts on a physical sector boundary. Some unused 
space might exist between the logical records. 

Extendable contiguous files have essentially the same features as 
contiguous files, with one important exception: they are 
extendable up to the capacity limit of the disk. By making 
suitable choices of block sizes, random access performance of 
these files will be equivalent to that of contiguous files. 

See the OS/32 Application Level Progrcuiuner Reference Manual for 
a full explanation of supported file types. 
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When transferring files from one disk to another, the Disk Backup 
Utility writes the files onto the destination disk in a 
contiguous manner as long as there are no bad sectors. This 
minimizes access time on the destination disk for indexed files 
and maximizes the aunount of contiguous free space on the 
destination disk. The Disk Backup Utility can copy the files 
onto an empty destination disk or onto a disk already containing 
f iles . 

The Disk Backup Utility performs the following functions: 

• Directly transfers files from one disk to another; the output 
disk serves as a backup of the original 

• Transfers files from an input disk to an intermediate magnetic 
tape device; the magnetic tapes are used as a backup 

• Appends files from an input disk to a magnetic tape containing 
previously backed up files; backup can be requested to locate 
the end of previously backed up files on the tape or can be 
notified that the tape is already positioned for the current 
backup operation 

• Restores the data from the intermediate device to an output 
disk 

• Verifies data copied during the backup operation 

• Verifies data that was copied during a previous execution of 
the utility 

• Selectively dumps individual files ftom disk to disk or from 
disk to tape 

• Modifies the account numbers of files dumped from various 
accounts to one single account number during a disk to disk or 
disk to tape backup procedure 

• Selectively restores files from tape to disk 

• Modifies the account numbers of selectively restored files 
from various accounts to one single account number during a 
disk to disk or tape to disk restore procedure 

• Selectively dumps files changed since a given time 

• Deletes and replaces files on an output disk 

• Transfers files created under OS/32 to OS/16 media or vice 
versa 

• Displays the starting parameter specified, date of the Disk 
Backup Utility operation, and names of files backed up 
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3.2 DISK BACB:UP UTILITY MAGNETIC TAPE FORMAT 

When copying files onto magnetic tape, the output tape created by 
the Disk Backup Utility is in the following format: 



/ f 

I 
I 

j Volume header 

I 

^ ^ 

Bytes: 




FIB 



Data 



E 
O 
F 



FIB 



Data 



79 80 



- < i 

EOF EOV 
5 i- 



Fields: 



Volume header is 80 bytes long and contains the following 

fields: 



• Disk volurne (volume name of input disk) 

• Sequence number of tape, starting with 1 

• Number of blocks written on the preceding 
tape 






Size of buffer used to transfer data 
Revision and update number of backup used 
Start options specified 
Date files backed up 



FIB (file 

information 

block) 



provides information relative to the file. 
It precedes the data of each file and contains 
the fields listed below. 



Filename, extension, and account number 

File type 

Keys 

Logical record length 

For contiguous and extendable contiguous 
files, the number of records 
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• For indexed and nonbuffered indexed files, 
data block size and index block size 

• Date and time the file was created 

• Date and time the file was last changed 



Data 

EOF 
EOV 



indicates the disk block image of the data on 
the f i le 

indicates end of file 

indicates end of volume 



NOTE 

If a very large buffer size is specified 
in the START command, the user must 
ensure that the tape has a sufficient 
length of trailer following the end of 
tape marker or the tape might run off the 
reel in an attempt to write the last 
record. 



For multivolume tapes; e.g., backup using two tapes, an EOV is 
written on the first tape and the following message is displayed: 

PLEASE MOUNT TAPE NUMBER XX 

The volume header is written to the new tape and the remaining 
data is copied. The format is: 



TAPE 1 



Volume header 



FIB 



Data 



EOF 



FIB 



Data I EOF 



EOV I 



TAPE 2 



Volume header 



Remaining data 



EOF 



EOV 
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3.3 DISK BACKUP UTILITY REQUIREMENTS 
The Disk Backup Utility requires: 

• approximately 17kb of memory, plus additional memory required 
for buffers; 

• a console device; 

• at least one currently supported disk device and an additional 
disk or magnetic tape; and 

• the version of the operating system with which the utility was 
released. 



The Disk Backup Utility uses any additional memory available up 
to CTOP to expand its buffers. Utility execution times are a 
function of buffer size and decrease as buffer size increases. 

3.4 OPERATING PROCEDURES 

The Disk Backup Utility executes as a privileged user task 
(u-task) and must be built a^i such by using Link. Use of the 
SYSSPACE command ensures sufficient system space for copying 
files with large block sizes, See the OS/32 Link Reference 
Manual for further information on the SYSSPACE command. 

If the user wishes to run the Backup Utility from the MTM 
terminal, their account must be authorized with bare disk 
privileges and file account privileges. 

To reduce the possibility of errors in a data transfer to 
magnetic tape, the recommended blocking factors are: 

TAPE 
RECORDING BLOCKING 

DENSITY FACTOR 

800 BPI 12. 5K 

1600 BPI 25. OK 

6250 BPI 100. OK 

These blocking factors refer to the size of the blocks on tape 
and are controlled by the SIZE parameter of the START command. 

Using larger blocking factors thain those recommended gains little 
additional storage space and results in an insignificant 
reduction in processing time. However, it does increase the 
probability of data transfer errors resulting in verify errors. 
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AIL disks used by the Disk Backup Utility must be marked online. 
The input disk can be marked online protected. When performing 
a backup from a fixed disk to a removable disk, the fixed disk 
must always be marked online protected, provided the disks are on 
the same disk drive. If the input disk is online protected, 
users can read from, but not write to, any files on the volume. 
If the input disk is not protected, users can read from and write 
to all files on the volume. 

The Disk Backup Utility runs faster if the disks are marked on 
with the secondary directory option. If the secondary directory 
option is used on an output disk, an expansion factor should be 
used to ensure that no directory overflow occurs. (Default for 
the expansion factor is 100 files.) 

If the Disk Backup Utility attempts to copy a file that is 
currently assigned with write privileges, a message is output 
indicating the file cannot be copied. If option SKIP is in 
effect, the program skips to the next file without pausing. If 
option SKIP is not in effect, the Disk Backup Utility pauses 
after logging the message. At this point, the condition can be 
corrected by closing the file. When the utility is continued, it 
attempts to copy the same file. 

The integrity of all files is assumed. To guarantee successful 
execution of the program, either the output disk must be 
initialized prior to executing the Disk Backup Utility or, if 
files are to be restored in selective mode, the disk must be in 
a valid state. Initialization ensures that any bad sectors on 
the disk are avoided during the operation and that all file 
entries are removed from the disk directory. The integrity of a 
disk is ensured by executing either the Fastchek Utility or the 
Disk Integrity Check Utility. See Appendix B in this manual or 
the Fastchek Reference Manual for more details on these 
utilities. 

NOTE 

The Disk Backup Utility does not save 
temporary, spool, SYSTEM. DIR, or 
PACK INFO. DIR files. All filenames are 
output to the list device as they are 
copied, which provides the operator with 
a log of the files contained on a given 
tape . 

Follow the procedure listed below to load and start the Disk 
Backup Utility: 
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1. Load the Disk Backup Utility using the LOAD command as 
follows : 



LOAD BACKUP, n 

n is thB segment size increment, which 

is the maximum space available to the 
task ( in kb) . 

2. Select backup as the current task using the TASK command as 
follows : 



TASK BACKUP 

3. If an empty disk is used as an output device, it must be 
already initialized using the Fastchek Utility or the Disk 
Initializer Utility. See the OS/32 Fastchek Reference Manual 
or Appendix A of this manual for more details on these 
utilities. 

4. Mark the disk used as input online, (optionally) protected 
using the MARK command as follows: 

MARK dm: ,0N 

or 
MARK dm: , ON, PROTECT 

5. Use the MARK command to mark the output disk online: 

MARK dm: ,0N 

Use of the secondary directory option (CD) to mark the input 
and output disks online will achieve improved performance. 
The format of the commands are as follows: 

MARK dm: ,0N, , CD 

or 
MARK dm : , ON , PROTECT , CD 

These commands, using the secondary directory option (CD), 
are to be used in place of the other commands (listed in 
procedures 4 and 5 above) to achieve improved performance. 
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start the Disk Backup Utility using 
Filenames are read until an end of data 
is found or until the maximum number of 
selected in one operation (40 if size 
the START command) is found. 



the START command, 
indicator (/* or ./) 
files that can be 
was not specified in 



Format : 



START ,lN=dev: ,QUT=dev: ,LIST=fd (7ai2E=rr] 

(7£QMMAND=fd] QeND] rDELETE^MODATECHECK]] 

rj^EIFY[yCOUNTj][[yQ [/count]] [TaBORt] CsiilC] [lACCOUNT = act] 

"/AEPEND 



rsiliCE=('mon/dd/yYl ,hh:mm [Ts^ [7s£LECT«fd] 
^dd/mon/yyj 




_VNQREWIlsfD/'_ 



[Tnewdate] 



Parameters; 



IN= 



OUT= 



END 



LIST= 



SIZE= 



dev: is the device mnemonic of the input 
device (the device from which data is copied) . 
This device is assigned for sharable read only 
to logical unit 1 (lul). 

dev: is the device mnemonic of the output 
device (the device to which data is copied). 
The utility assigns lu2 SRO for disk to disk 
copies; SRO for tape to disk copies; and ERW 
for disk to tape copies. 

indicates stop scanning parameters (not needed 
unless COMMAND^fd is being used). 



fd is optional in the START 
required assignment. fd 
descriptor of the list device 
and messages. The list 
preassigned by the user to lu7 
the START command, the list device 
for sharable write only to lu7. 



command but a 

is the file 

for filenames 

device may be 

If entered in 

is assigned 



n is the buffer size in kb requested for disk 
to tape operation. The default size is 13kb. 
n is a decimal number with optional decimal 
places; e.g., 16.50. 
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COMMAND- 



fd is the input device from which additional 
parameters are to be taken, this allows the 
user to continue entering more arguments after 
the START parameter line is filled. 
COMMAND^fd may appear anywhere in the START 
parameter list. All parameters in the list 
are processed. After processing the START 
parameter list, additional parameters are read 
from the specified fd. The parameters are in 
the same format as the START parauneter list 
and are processed until the parameter END is 
encountered. 



DRLETE/ 
NODATECHECK 



If DELETE is specified, the file on the output 
disk is deleted and replaced, only if the last 
written date indicates it is an older version 
than the file on the input medium. The 
additional parameter NODATECHECK overrides 
this provision. 



If DEr.ETE is specified and the file on the 
output disk is not an older version than the 
one on the input medium, BACKUP will display 
an error message and pause. Specification of 
DELETE and SKIP will cause the file to be 
skipped unless other errors are encountered. 



The list of backed up files output during the 
Disk Backup Utility operation indicates if a 
file was deleted and replaced. It also 
indicates if a file was not deleted due to a 
date check. If DELETE and SKIP are specified, 
files already existing on the output disk are 
deleted. Files are only skipped if other 
errors are encountered. 



NOTE 



When the DELETE 
specified with the 
program operation is 



parameter is 
START command, 
slower . 



VERIFY 



indicates that data on the input and output 
devices is verified after all files have been 
copied. If the data does not verify, the 
nonverifying records from both files are 
output to the list device along with an error 
message. 



COUNT 



is a decimal number that indicates the number 

of records in a file that must fail to verify 

for Backup to skip the remainder of the file. 
If omitted, 5 is the default. 
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vo 



ABORT 



SKIP 



ACCOUNT= 



SINCE 



indicates data on the input and output devices 
is verified only. No copy operation is 
performed. Any records that do not verify are 
output to the list device. 

terminates program if non-zero status is 
returned following an I/O operation or when 
allocating or assigning a file. If ABORT or 
SKIP is not specified, the task pauses. 



any files that cannot be success 
on the output disk by the Disk B 
are not transferred. The files 
in an error message and the pr 
the next file instead of paus 
files were skipped during the c 
a message is generated and v 
performed. If neither SKIP 
specified, the task is paused. 



fully assigned 
ackup Utility 
are identified 
ogram skips to 
ing. If any 
opy operation, 
erify is not 
nor ABORT is 



If SKIP is in effect and an I/O error is 
encountered on the tape during a tape to disk 
restore, the current file being restored is 
closed as is, and the restore is continued at 
the next file. If verify is the current 
operation, the file is not verified. 

specifies the account number to which all 
files being backed up or restored are to be 
changed. Backup reads the file from the input 
device, changes the account number to the 
specified account number, and sends the file 
to the output device. 

mon/dd/yy is the name of the month, day, and 
year. hh:mm:ss is the hour, minutes, and 
seconds. This option enables the user to back 
up or restore files changed since the 
specified date. The first three letters in 
the name of the month must be entered; the 
complete name can be entered. The month 
mnemonic should be followed by a slash and a 
two digit number for the day. The day should 
be followed by a slash and a two digit number 
for the year. The date can be entered with 
the month or day first. If the SINCE option 
is not specified, then no check is made of the 
date when a file was last changed- If the 
SINCE option is used in conjunction with the 
SELECT option, a file must have been changed 
since the given date and must match a SKLECT 
entry in order to be backed up or restored. 
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SEr.ECT= fd selectively copies or restores, and/or 
verifies, f^les from disk to disk, disk to 
tape, or tape to disk. fd is the file or 
device from which filenames to be restored or 
verified are specified or entered. The Disk 
Backup Utility assigns this fd to lu5. 

The number of select entries that can be 
entered in an operation is limited by the 
segment size. Up to 40 select entries can be 
entered without additional memory from the 
segment size increment. Each additional 
select file in excess of 40 requires 16 
additional bytes of memory. The SELECT option 
can be used in conjunction with the SINCE 
option, in which case the file must match a 
SELECT entry and must have been changed since 
the given date. 

APPEND specifies that during a disk to magnetic tape 

backup operation. Backup is notified that the 
magnetic tape output device contains backup 
format data and that additional backup files 
are to be added. Backup scans the tape for 
the end of volume mark. It removes the mark 
and begins the current backup operation. The 
end of volume mark is rewritten after the last 
file is backed up. This option disables the 
VERIFY option. 

POSITION specifies that during a disk to tape backup 
operation, Backup is notified that the 
magnetic tape output device contains backup 
format data, the files are to be appended to 
the tape, and the tape Is already positioned 
at the end of volume mark. The tape is 
backspaced one record, the end of volume mark 
is removed, and the current backup operation 
begins. The end of volume mark is rewritten 
after the last file is backed up. This option 
disables the VERIFY option. 
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NOREWIND 



specifies that during a disk to tape backup or 
restore operation, Backup is notified that the 
magnetic tape output device is positioned at 
the point where the current backup operation 
is to begin. If writing to the tape, backup 
will write a backup format volume header 
followed by the files to be backed up. If 
Backup reads from the tape, the first record 
encountered on the tape must be a backup 
format volume header. This option disables 
the VERIFY option. 



CAUTION 

BECAUSE BACKUP ASSUMES THAT THE 
TAPE IS PREPOSITIONED WHEN THE 
POSITION OR NOREWIND PARAMETERS 
ARE ENTERED, CAUTION SHOULD BE 
EXERCISED WHEN USING THESE 
OPTIONS. IF THE TAPE IS NOT 
CORRECTLY POSITIONED, PREVIOUSLY 
BACKED UP FILES COULD BE 
OVERWRITTEN AND LOST. 



NEWDATE 



specifies that the date created and 
written for each backed up file are 
make them current dates. 



date last 
updated to 



Functional Details: 



When started, the Disk Backup Utility prints the message: 



PERKIN-ELMER OS/32 BACKUP 03-153 Rxx-yy 



where xx 
Utility, 



and yy identify the revision level of the Disk Backup 



If the SELECT=fd parameter is specified in the START 
a message displaying the maximum number of SELECT 
output to the 



console and list device, 



read from the 
indicator (/* 
files that 
is reached. 



spec if ied 
or ./) is 
can be selected 
More than one 



selected) are then 

until an end of data 

maximum number of 

(default = 40 files) 

can be specified per 80-byte input record 

by commas (,) or by semicolons ( ; ) • After 

been entered, the Disk Backup Utility 

operation. 



statement, 

entries is 

Filenames (to be 

file or device (fd), 

found, or until the 

in one operation 

select filename 

by separating the fds 

all filenames have 

starts the requested 
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This header is output on the list device; 



BACKUP xx-yy DATE RUN datetime Volume xxxx Size xx.xx 



On a disk to disk or disk to tape operation, the volume naune of 
the input device is displayed. If a tape restore is being done, 
the volume name displayed is the name of the output disk. 



Backup then proceeds with the requested operation, 
successful completion this message is printed: 



Upon 



END OF TASK CODE- 



If any errors (other than a verify error) occur, this message 
logged on the system console and printed on the list device: 



IS 



END OF TASK CODE 



If an error occurs during a verify operation, this message 
logged on the system console and printed on the list device: 



IS 



END OF TASK CODE = 2 

When a tape restore is successful, the following message is 
generated using information supplied from the original disk to 
tape operation. 

BACKUP INFORMATION FROM TAPE: 

BACKUP xx-yy DATE RUN date time VOLUME xxxx SIZE xx.xx 

CAUTION 

WHEN RESTORING FILES TO DISK FROM 
MAGNETIC TAPE, ALWAYS REMOVE THE WRITE 
RING FROM THE TAPE PRIOR TO MOUNTING THE 
TAPE. THIS PRECLUDES THE POSSIBILITY OF 
INADVERTENTLY WRITING ON AN ALREADY 
BACKED UP TAPE AND THE SUBSEQUENT LOSS OF 
FILES. 
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When selecting files for a backup or restore operation, it is 
possible to reduce the number of repetitive filename entries by 
using partial f ilenaunes. A hyphen (-) in the f ilehautie specifies 
that all files starting with the characters preceding the hyphen 
are to be be backed up or restored, subject to any restrictions 
specified in the extension or account number fields. 



Examples : 
CAL32- 



selects for backup or restore 
operations all files whose first 
five characters are CAL32. 



■I'ESTPROG- 



selects for backup or restore 
operations all files named TESTPROG 
with any extensions. 



The asterisk character (*) requests that all files with matching 
characters in the same positions as those entered be selected. 



Examples: 

CAL32*** 



selects for backup or restore 
operations all files between five 
and eight characters in length whose 
first five characters are CAL32. 



****32.0BJ 



selects for backup or restore 
operations all files with a filename 
containing six characters whose 
fifth and sixth characters are 32 
and whose extension is OBJ. 



The characters * 
selected files. 



and - can be combined to further delimit 



Example: 



CAL**1- 



selects for backup or restore 
operations all files whose first 
three characters are CAL and whose 
sixth character is 1 with any 
extens ion. 



When selectively restoring files from magnetic tape to disk, it 
is not necessary to read tapes prior to the tape containing the 
first file to be restored or verified. The program may be 
started with the first tape containing files to be restored or 
verified; whether that tape is the second, third, fourth, etc., 
tape of a set. Once the restore operation has begun, however, 
succeeding tapes must be mounted and read consecutively. 
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Exaunples: 



START, rN=DSC2: ,0UT=DSC1: , VERIFY, A, LIST-PR: 



Copies DSC2: to DSCl:, verifies, 
aborts on errors and sends listing 
to PR: 



ASSIGN 7, PR: 

START, 0UT«DSC1: , IN=DSC2: ,VE 



Preassigns list device to lu7; 
collies DSC2 to DSCl, and verifies. 



START , IN-DSC1:,0UT=MAG1:,LIST=PR:,SIZ=4.5,VE,A 



Copies disk to tape, buffer 
st2e ^ 4.5kb, verifies, aborts on 
errors, sends listing to PR:. 



START , IN-MAGl: ,0UT=DSC2: ,LIST=PR: ,A,VE,DEL 



Copies tape to disk, aborts on 
er?ors. If filenames match, 
restores only if the file from tape 
has a more recent date. 



START , IN«MAG1: , 0UT=DSC2 : , LI=PR: ,V0 



Verifies files from tape to disk but 
does not copy files. 



START , IN==DSC5: ,0UT=MAG1: ,L»PR: ,SEL=CON: 



Selectively backs up files from disk 
to tape and reads filenames from the 
console (CON:). 



START ,COMMAND=CON: , IN=DSC1: 
BACKUP >0UT=MAG1:,LIST=PR: 
BACKUP >Sl[NCE=MAR/17/83, 12:30 
BACKUP >V!!RI,END 



Copies all files from disk changed 
since March 17, 1983, at 12:30 to 
tape. 
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3.4.1 Multiple Disk Backup 

Backup of data from the fixed disk to the removable disk may- 
require the use of multiple removable disks because the removable 
disk has a much smaller storage capacity than the fixed disk. 



NOTE 

Fixed disk to removable disk backup 
operations must be performed in a 
stand-alone environment with no other 
tasks running on the system. If other 
tasks are running while Backup is being 
performed, the system does not allow the 
user to mark the fixed disk off. 

When Backup has filled a disk, the following message is 
displayed: 

Pr.EASE MARK OFF THE INPUT DISK 

PLEASE MARK OFF THE OUTPUT DISK AND MOUNT NEXT DISK VOLUME 

TASK PAUSED 

Follow this procedure to replace the removable disk and continue 
the backup operation: 

1. Mar-- off the removable disk, using the MAEUC command. 

2. Mark off the fixed disk, using the MARK command. 

3. Power -down the drive. 

4. Remove the removable disk and mount the next removable disk 
to be used. 

5. Power -up the drive. 

6. Mark the fixed disk on protect, using the MARK command. 

7. Mark the removable disk on, using the MARK command. 

8. Continue Backup, using the CONTINUE command. 

Backup will not split a file between two disks. If backup cannot 
fit the entire file onto a disk, it will request that a new disk 
be mounted. Backup will then write the entire file onto the new 
disk. A file can be no larger than the total storage capacity of 
the output disk. 
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Disks that already have files residing on them can be used in 
Backup operations. Backup will not overwrite these files, but 
will use the remaining free space on the disk. 



3 . 5 MESSAGES 



ASSIGN ERROR FILE fn/message 



indicates that bad statgs was encountered while trying to 
assign to a device through the START command or while 
trying to allocate or assign a file. This message 
specifies the type of error depending on returned SVC 7 
status. 



DATE -ERR 

indicates invalid day, year, or month in START command. 

DEVICE UNAVAILABLE FOR EXCLUSIVE USErxxxx 

indicates that device cannot be accessed exclusively; 
xxxx«device. 

ENTER FILENAMES TO BE COPIED 

indiccites progrcim request for filenames that are to be 
restored. If lu5 is assigned to the console, a prompt is 
output. 

ENTER FILiJNAMES TO BE VERIFIED 

indicates progrsim request for f ilensunes that are to be 
verified only. If lu5 is assigned to the console, a 
prompt is output. 

FD-ERR 

indicates invalid fd in START command. 

FORM-ERR 

indiceites syntax error in START command. 
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INCORRECT NUMBER OF RECORDS TRANSFERRED 

indicates that the number of data blocks written on the 
previous tape during a multivolume disk to tape operation 
is not equal to the number of data blocks read during 
tape to disk operation. 



INPUT DISC CONTAINS NO FILES 

indicates that no directory was found on input disk. 

INPUT DISK MUST BE MARKED ON "PROTECT" 

indicates that in an attempt to backup data from a fixed 
disk of a 10Mb disk to a removable disk of the same pack, 
the input was not marked online with a protected status. 
Backup pauses. The input disk must be marked OFF and 
then marked ON PROTECTED, and the task continued. 

INSUFFICIENT MEMORY 

indicates that not enough memory is available. Reload 
the program into a larger segment and restart. 

INVALID DEVICE CODE 

indicates use of an invalid device code or that a 
magnetic tape is specified as both the input and output 
device . 

INVALID FILE TYPE, FILE fn NOT TRANSFERRED 

indicates that file type of file fn is not contiguous or 
indexed. 

INVALID TAPE VOLUME xxxx, EXPECTING xxxx 

indicates that the currently mounted multivolume tape has 
not been created from the same input disk. 

I/O ERROR LU=xx STATUS=yy ON fd:fn.ext 

indicates that an I/O error was encountered during an SVC 
1 read or write operation from a device or file. The lu 
is XX, • yy is the error status. 
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LU XX [JNA£5 SIGNED 

indicates that the input, output or list device was not 
assigned. 



MARK INPUT DISC ON 

indiccitea that input disk has not been marked on. 

MARK OUTPUT DISC ON 

indicates that the output disk is offline. 

NON-VERIFY:FILE fn LOGICAL UNIT x: RECORD NUMBER xxxx 
indiccites that data in the file fn does not verify. 

OPTION VERIFY 

indicates that the program started a verify routine. 

OS/32 BACKUP xx-yy 

indicates that the program is operational. The program's 
revision level is xx; yy is the update level within the 
revision. 

OS/32 Rxx-yy REQUIRED 

indicates that backup is being run on an incompatible 
operating system. Revision xx-yy or higher of the 
operating system is required. 

PLEASE MARK OFF THE INPUT DISC 

PLEASE MAfUC OFF THE OUTPUT DISC AND MOUNT NEXT DISC VOLUME 

indiccites that the end of volume was reached before all 
files were copied and another volume must be mounted. 

PLEASE MOUNT TAPE NUMBER xx 

indiccites that the end of a tape was reached before all 
files were copied or verified, or the tape currently 
mounted is not the first tape at the start of the verify 
routine. 
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SELECTED FILES EXCEED MAXIMUM 

indicates that the maximum number of files allowed during 
selective restore/verify was exceeded. 



SELECTED FILES NOT COPIED 
fn 



indicates that specified files were not found on the disk 

or tape after a selective restore operation. All 

filenaunes not processed are listed following this 
message . 



SELECTED FILES NOT VERIFIED 
fn 



indicates that the specified files were not found on the 
disk or tape after a selective verify operation. The 
filenaunes follow this message. 



SELECTIVE RESTORE MAXIMUM ENTRIES=xxx 

indicates that the mode is selective restore. The 
maximum number of selected entries is xxx. 



SELECTIVE VERIFY MAXIMUM ENTRIES=xxx 

indicates that the mode is selective verify only. The 
maximum number of selected entries is xxx. 



SKIP IN EFFECT VERIFY IGNORED 

indicates that files were skipped during the copy 
operation. Verify cannot be performed. 



SYNTAX ERROR fn 

indicates invalid syntax in filename for selective 
restore. 
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TAPE OUT OF SEQUENCE, SEQU-XX 

indicates that the curreiatly mounted tape does not have 
the expected sequence nuimber . The sequence number on the 
volume label of the currently mounted tape is displayed. 

TIME -ERR 

Indicates invalid hours, minutes, or seconds in the START 
command . 



***TAPE ERROR - FOr.LOWING FILE PARTIALLY RESTORED 

indicates that the file was partially restored during a 
tape to disk restore; the remaining part of the file was 
skipped. 
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APPlSNDIX B 
DISK INTEGRITY CHECK UTILITY 



B.l GENERAL DESCRIPTION 

The Disk Integrity Check Utility provides a means of recovering 
open disk files following an operating system failure. This 
utility is also used to restore the integrity of data on disk 
volumes- This condition can occur if the disk is dismounted 
without being marked offline. A system failure has the effect of 
dismounting online disk volumes. The program rebuilds the bit 
map and validates file pointers of indexed and contiguous files. 
Directory blocks with no active entries are deleted unless they 
were preallocated by the Disk Initializer Utility. 

All temporary files are deleted. Spool files that had not been 
closed and sent to the Spooler are deleted. A spool file is also 
deleted if it was created more than 24 hours before the current 
date. If there are spool files more than a day old that are to 
be kept on the disk, an earlier date can be entered via the 
operating system SET TIME command before running the Disk 
Integrity Check Utility. Spool files with a creation date later 
than the current date are not deleted. 

If a disk volume is inadvertently dismounted without being 
properly marked offline, it can only be marked online in a write 
protected mode; e.g., MARK Dl: , ON, PROTECT. The Disk Integrity 
Check Utility must be executed before the MARK command can be 
entered without the PROTECT option. 
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The Disk Integrity Check Utility closes all files that are 
assigned, sets the date last written if the file was open for 
write, and validates all control information on the disk. The 
latter function is performed in case bad data was written to the 
volume during a system failure. Complete volume recovery is not 
always possible because bad data might have been written to the 
volume prior to the failure. The program's output messages 
explain the status of individual files or the entire disk and 
describe what actions have been taken or attempted. 

WARNING 

IT IS IMPERATIVE TO RUN THE DISK 
INTEGRITY CHECK UTILITY WHENEVER THE 
INTEGRITY OF A DISK IS IN QUESTION. 
FAILURE TO DO SO IMMEDIATELY CAN RESULT 
IN THE UNNECESSARY LOSS OF DATA AND 
FILES. 



Systems without direct access devices need only restore the 
operating system environment that existed prior to the system 
failure. No further action is required. Systems with direct 
access devices that did not have any direct access devices marked 
online at the time of the system failure can be recovered using 
the procedure for systems without direct access devices. It is 
not always possible to determine if any files were assigned; 
i.e., a program might have made an assignment using supervisor 
call 7 (SVC 7). Therefore, it is recommended that the Disk 
Integrity Check Utility be used on all systems with online direct 
access devices. Failure to execute this utility after a system 
failure can leave direct access volumes in a state where files 
can be rieither assigned nor deleted. 

B.2 DISK INTEGRITY CHECK UTILITY REQUIREMENTS 
The Disk Integrity Check Utility requires: 

• memory of 7.75kb above the operating system size, plus an 
optional buffer for the read check operation; 

• a console device; 

• a list device (can be the console device); and 

• any currently supported disk device. 

The Disk Integrity Check Utility is provided for the user in both 
object and image format. If an object version is to be used, it 
must be established as a privileged user task (u-task) using 
Link. 
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If the READCHECK option is selected, as many sectors up to one 
cylinder that can be accommodated into a buffer between UTOP and 
CTOP are read. Therefore, when READCHECK is selected, the speed 
of the program increases if sufficient memory is available to 
read one entire cylinder. See Table A-1 for optimum segment size 
increments. 



B.3 OPERATING PROCEDURES 

The following six procedures are recommended after an operating 
system failure for systems configured with direct access devices: 

1. Reload the operating system. 

2. Mark the system volume on, protected. 

3. Load the Disk Integrity Check Utility using the LOAD command. 

4. Select the Disk Integrity Check Utility as the current task 
using the TASK command. 

5. Mark the disk to be checked offline. 

6. Start the Disk Integrity Check Utility by using the START 
command . 

Format: 



START ,dev: ,[list fd ] 



,<liOREADCHECK 
£EADCHECK 



Parameters: 



dev: 
list fd 

CLOSE 



is the name of the device. 

is the file descriptor of the device or file 
to which the Disk Integrity Check messages are 
displayed. 

specifies that all open files assigned for 
read only are closed. A message is printed 
and the files are closed, but no data is lost. 
An indexed file open for write causes a 
message to be printed? the file is not closed. 
In this casej the Disk Integrity Check Utility 
must be rerun without the CLOSE option. 
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NOREADCHECK 



READCHECK 



specifies that no readcheck is performed. 
When the Disk Integrity Check Utility clears 
the bit map, all sectors previously flagged 
defective are freed. This option should never 
be specified if a disk is known or suspected 
to have bad sectors. If this parameter is not 
specified, READCHECK is the default. 

specifies that the program is to search for 
bad sectors. Any bad sectors are marked as 
allocated in the bit map, and a message is 
output. The program reads as many sectors as 
it can, up to one cylinder, into a buffer. If 
zero status is returned, the next group of 
sectors is read. This process continues until 
the entire disk is checked. If non-zero 
status is returned, a sector by sector read is 
performed until the bad sectors are located. 



Examples: 



ST ,DSC1:,C0N: 

ST ,DSC1: 

ST ,DSC1:,PR: 

ST ,DSC1: ,CON: ,R 

ST ,DSC1:,C0N: 

ST , DSC 1 : , CON : , CLOSE 



Normal program with read check 

Normal prograim with read check (list 
device was preassigned) 

Normal prograun with read check 

Normal program with read check 

Normal prograun 

Close files only 



Messages : 



ASSIGN ERROR CODE xx 

indicates that the program attempted to assign either 
logical unit 1 (lul) or lu3 to their respective file 
descriptors. The returned SVC 7 status is xx. 

BAD DIRECTORY -CHAIN BROKEN- (reason n) 

indicates that a pointer to a directory block is not 
valid because the directory itself is no longer valid. 
The directory chain is broken; that is, directory entries 
further down the directory chain are no longer accessible 
to any program, and the files that they defined are lost. 
To obtain a list of the valid files, use the DISPLAY 
FILES command. 
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Because OS/32 R06.2 contains two new file types, 
nonbuffered index and extendable contiguous, the files 
displayed by the DISPLAY FILES command might have files 
displayed under an NB or EC heading. See Chapter 3 for 
an explanation of the two new file types supported. 



Invalid pointer to directory block (reason 2). 

Unable to mark a directory block as allocated in the 
bit map (reason 1) . 



BAD FILENAME filename 

indicates that a filename does not conform to the 
operating system naming conventions. The file is 
deleted. 



BAD PACK-BEINITIALIZE 

indicates that the disk cannot be checked because an 
input/output (I/O) error (other than wr ite-protect) was 
encountered. 



BAD SECTOR, LBA=nnnnnn 

indicates that a bad sector was found during a read check 
operation. The sector is marked as allocated in the bit 
map. The hexadecimal logical block address is nnnnnn. 



CHAIN BROKEN ON FILE filename 
indicates that either: 



• when examining an indexed file, the forward pointer of 
the last index block was not zero. This causes the 
last forward pointer to be reset to zero. The first 
sector of the last index block is rewritten, or 

• the backward pointer of an index block did not point 
to the previous index block. The FILE fileneune 
DELATED message is then printed. 



DATA POINTERS FOLLOWING LAST POINTER NOT ZERO, FILE filename 

indicaites that the data block pointers following the last 
calculated pointer in an indexed file were non-zero. 
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DEVICE NOT DISC 

indicates that lul is not assigned to a disk, or the 
first fd in the START conunand is not a disk fd. 



DISCCHECK xx-yy 

indicates that the progreim is operational. The current 
revision level of the Disk Integrity Check Utility is xx; 
yy is the update level within the revision. 



FD-ERR 

indicates that an invalid fd or volume name was issued in 
the START command. 



FILE filename ASSIGNED FOR WRITE, COUNTS NOT RESET 

indicates that non-zero write counts were found in an 
indexed file during execution of the CLOSE option. The 
integrity of the disk has not been restored and the 
program must be re-executed without the CLOSE option. 

FILE filename DELETED- (reason n) 

indicates that a previously active directory entry was 
marked inactive. This message is issued for one of the 
following seven reasons: 

• An invalid directory pointer (reason 2) 

• Spool file not closed (reason 6) 

• Spool file more than a day old (reason 7) 

• An invalid file type 

• Unable to mark a used sector as allocated in the bit 
map (reason 1) 

• A contiguous file with the last logical block address 
less than the first logical block address (reason 5) 

• Temporary file (reason 9) 
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This message is output for an indexed file if : 



An invalid block size 



was encountered 



The index or data pointers are invalid (reason 2) 

The calculated number of data blocks does not agree 
with the actual number of data blocks between the 
first and last logical block addresses 

Unable to read index block (reason 4) 

The first data block address (FLBA) is 0, but the 
number of logical records is nonzero (reason 3) 

The last data pointer is not contained in the last 
index block (reason 8) 

A backward pointer of an index block does not point to 
the previous index block 



FORM-ERR 



indicates the options in the START command do not conform 
to specifications. 



INCORRECT BLOCK COUNT ON FIUS filename 

indicates that the calculated block count does not equal 
the actual number of data blocks for an indexed file. 
This message is follovi/ed by message FILE filename 
DELETED. 



INVALID BLOCKS I ZE OF ZERO ON FILE filename 

indicates that the blocks ize field in the directory is 
zero for an indexed file., The file is deleted. 



INVALID FILE TYPE, FILE filename 

indicates that the file type field in the directory is 
not contiguous or indexed. The file is deleted. 



10 ERROR ssdd 

indicates that a non-zero status was received. The 
program is then paused. The device independent status is 
ss? dd is the device dependent status. 
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10 ERROR ssdd L4BA=nnnnnn 

indicates that a non-zero status was received while 
trying to read or write a sector on the disk. The device 
independent status is ss? dd is the device dependent 
status; nnnnnn is the hexadecimal logical block address. 

OS/32 Rxx-yy REQUIRED 

indicates that this version of the Disk Integrity Check 
Utility is being run on an incompatible operating system. 
Revision xx-yy or higher of the operating system is 
required. 



PACK IS HARDWARE PROTECTED 

indicates that the disk cannot be checked because the 
pack is hardware protected. 



POTENTIAL LOST DATA ON FILE filename 

indicates that a file was restored to a valid state and 
closed by the progrsun. If the file was open for write, 
the date last written is set to the current date. There 
could be a potential loss of data. 
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